Skip to content

快速开始

本页完成三件事:准备 API Key、查询可用模型、发起一个最小请求。

1. 准备 API Key

登录 NewAPI 控制台,在令牌页面创建令牌。建议为不同应用分别创建令牌,并按用途设置额度和模型权限。

在终端设置变量,避免把密钥直接写入脚本:

bash
export NEWAPI_BASE_URL="https://newapi.fq-hx.com"
export NEWAPI_API_KEY="sk-替换为你的令牌"

2. 查询可用模型

bash
curl -sS "$NEWAPI_BASE_URL/v1/models" \
  -H "Authorization: Bearer $NEWAPI_API_KEY"

只有返回列表中出现、且令牌所属分组有权限的模型才能调用。模型名称应原样传入 model 字段。

3. 发起聊天请求

bash
curl -sS "$NEWAPI_BASE_URL/v1/chat/completions" \
  -H "Authorization: Bearer $NEWAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "替换为可用模型名",
    "messages": [
      {"role": "user", "content": "你好,请用一句话介绍自己。"}
    ]
  }'

4. 接入 AI 编程工具

本站可以作为 Codex、Claude Code 和 OpenCode 的模型网关,但三者使用的接口协议不同:

工具接口协议配置入口
CodexOpenAI Responses API~/.codex/config.toml
Claude CodeAnthropic Messages API环境变量或 ~/.claude/settings.json
OpenCodeOpenAI Chat Completions 或 Responses API~/.config/opencode/opencode.json

分别进入 CodexClaude CodeOpenCode 的独立配置文档。不要仅凭模型出现在 /v1/models 中就假设它兼容所有工具;还需要确认对应协议和工具调用能力。

5. 调用视频模型

视频生成是异步任务:提交成功只表示任务已经创建,并不代表视频已经生成。接口定义见视频任务 API,平台参数和示例见火山引擎 Seedance

常用请求头

请求头是否必需说明
Authorization格式为 Bearer sk-...
Content-TypeJSON 请求必需使用 application/json
Accept建议使用 application/json

下一步

本站提供 NewAPI 接入说明;模型能力与审核规则以上游平台最新规定为准。