接入指南

第一次 API 调用

创建 API Key，从实时目录选择准确的模型 ID，再按照模型指南发送原生 LLM 请求或创建媒体生成任务。

接入流程从准备到第一次请求

创建密钥01
API_KEY
在控制台创建密钥，保存在服务端。
选择模型02
模型 ID + 原生协议
从实时目录核对模型和输入要求。
完成第一次调用03
请求 → 响应
复制对应模型的请求示例并读取结果。

1. 创建密钥

示例中的平台 API 地址已填入。在终端设置 API_KEY 为你的密钥；它是环境变量名，不是模型 ID。

2. 选择模型

curl "https://newrouters.com/v1/models" -H "Authorization: Bearer $API_KEY"
curl "https://newrouters.com/v1/media-models"

使用实时目录中的准确 ID 和协议。预期模型不在目录时，先核对权限或可用性，不自动换成别的模型。

3. 阅读对应指南

GPT Image 2：创建并轮询图片任务。
GPT-5.5：发送 OpenAI Chat 请求。
完整 API 参考：支持的协议与公共接口。

发送一个图片任务

以下请求使用平台的 model + input 结构。运行会创建生成任务并产生消费，请先核对账号价格。

curl "https://newrouters.com/v1/tasks" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "gpt-image-2",
  "input": {
    "prompt": "A small red house in a quiet garden",
    "quality": "medium",
    "resolution": "1k",
    "output_format": "jpeg"
  }
}'

HTTP 202 表示任务已受理；响应字段节选如下（示意值）：

{
  "id": "TASK_ID",
  "status": "pending",
  "result": null,
  "error": null
}

通用 API：查询模型、账户积分余额和任务状态。

4. 查看结果与消费

curl "https://newrouters.com/v1/tasks/TASK_ID" \
  -H "Authorization: Bearer $API_KEY"

把 TASK_ID 替换为创建响应的 id。succeeded 时读取 result.assets[]；failed 时读取 error；pending 或 processing 时继续查询原任务。

媒体任务的创建响应不是最终生成结果。根据返回的任务 ID 轮询至成功或失败。LLM 调用保留请求 ID 和 usage，并在控制台查看消费记录。