Models / Embeddings / Images

GET /v1/models

返回当前 Key 绑定分组的可用模型并集（OpenAI 标准列表结构）：

curl https://api.nexuskey.cn/v1/models -H "Authorization: Bearer $NEXUSKEY_API_KEY"

{
  "object": "list",
  "data": [
    { "id": "claude-sonnet-4-5", "object": "model", "created": 1759536000, "owned_by": "anthropic" }
  ]
}

GET /v1/models/{model} 返回单模型对象；Codex 系客户端带 client_version 查询时返回其期望的 manifest 格式。

POST /v1/embeddings

参数	说明
model	嵌入模型原名
input	字符串或字符串数组

返回 OpenAI 标准 data[].embedding 与 usage。按上游支持度开放模型范围。

Images 系列

端点	说明
POST /v1/images/generations	同步生图（gpt-image-* 等）
POST /v1/images/edits	图编辑（multipart）
POST /v1/images/generations/async	异步提交，返回 task
GET /v1/images/tasks/{task_id}	异步任务轮询（只需鉴权，余额耗尽后仍可查询已完成任务）
POST /v1/images/batches	批量生图提交
GET /v1/images/batches[/{id}[/items…]]	批量任务列表/详情/条目/内容/下载
POST /v1/images/batches/{id}/cancel、DELETE …	取消/删除批量任务与产物

生图请求体遵循 OpenAI Images 结构（model、prompt、size、n 等）；异步与批量接口适合大图/多张场景，避免长连接超时。

平台限制

Images 端点仅 OpenAI 供给分组支持；分组内无生图账号时返回 404。视频类扩展端点未开放（404）。