# 第一次 API 调用

## 1. 创建密钥

登录 [API Key 控制台](/api-keys)，创建密钥并配置模型访问权限。密钥保存在服务端，不放进浏览器代码或 Git 仓库。

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

## 2. 选择模型

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

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

## 3. 阅读对应指南

- [GPT Image 2](/zh/docs/models/gpt-image-2)：创建并轮询图片任务。
- [GPT-5.5](/zh/docs/models/gpt-5-5)：发送 OpenAI Chat 请求。
- [完整 API 参考](/zh/docs/api)：支持的协议与公共接口。

### 发送一个图片任务

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

```bash
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 表示任务已受理；响应字段节选如下（示意值）：

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


- [通用 API](/zh/docs/common-api)：查询模型、账户积分余额和任务状态。

## 4. 查看结果与消费

```bash
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，并在控制台查看消费记录。