入门基础 / 入门 · 8 分钟

从零开始,完成第一次 API 调用

弄清地址、密钥和模型名称,用一个最小请求确认接入成功。

01先认清三个配置项

API 地址决定请求发往哪里,API Key 用于认证,模型 ID 决定调用哪个模型。在奈特使用的基础地址是 https://api.natnt.com/v1。密钥和可用模型以你自己的账户为准。ChatGPT 网页订阅与 API 服务是不同产品,不能直接互换额度。

02在自己的电脑保存密钥

不要把密钥写在网页、GitHub 或截图里。下面以 PowerShell 为例,只在当前终端会话中保存密钥;关闭会话后变量失效。命令会提示输入,避免将密钥写进命令历史。

03先获取账户可见的模型

执行模型列表请求,复制返回的一个准确模型 ID。模型出现在列表中,仍不代表它支持所有接口、图片或工具调用。

PowerShell / 本地执行
$secureKey = Read-Host "输入 API Key" -AsSecureString
$env:NATNT_API_KEY = [System.Net.NetworkCredential]::new("", $secureKey).Password
$headers = @{ Authorization = "Bearer $env:NATNT_API_KEY" }

# 查看当前账户可见的模型
Invoke-RestMethod https://api.natnt.com/v1/models -Headers $headers

# 替换成上一步返回且支持此接口的模型 ID
$body = @{
  model = "YOUR_MODEL_ID"
  messages = @(@{ role = "user"; content = "用一句话介绍你能做什么。" })
  max_tokens = 100
} | ConvertTo-Json -Depth 5

Invoke-RestMethod https://api.natnt.com/v1/chat/completions `
  -Method Post -Headers $headers -ContentType "application/json; charset=utf-8" `
  -Body ([System.Text.Encoding]::UTF8.GetBytes($body))

# 测试完成后清理当前会话
Remove-Item Env:NATNT_API_KEY

04发起一个最小文本请求

把示例中的模型 ID 换成实际值。这段示例使用 Chat Completions 接口;若所选模型只支持其他接口,需要按服务说明调整。先用短文本测试,不要第一次就批量运行。

05确认返回与用量

成功时应能看到回复内容;在 API 控制台核对用量和扣费。遇到错误,先看状态码,再排查地址、权限与模型兼容性。测试结束可移除会话变量。

相关入口:奈特 API 控制台

继续动手

把这一步用到你的任务里。

选择一份工作模板

找到你需要的教程

搜索本站教程 · 按 Esc 关闭