API 调用文档

聊天 / Codex

使用 OpenAI 兼容的 Chat Completions 接口。把 model 换成下面模型表里的模型名即可。

curl https://ai.yuyapi.cn/v1/chat/completions \
  -H "Authorization: Bearer sk-你的令牌" \
  -H "Content-Type: application/json" \
  -d '{"model":"模型名","messages":[{"role":"user","content":"你好"}]}'

图片生成

gpt-image-2 是异步图片任务：提交成功时通常只返回 task_id，不会立即返回图片 URL。下游软件不要从提交接口直接读取 data[0].url；必须保存 task_id，再轮询任务结果。

curl https://ai.yuyapi.cn/v1/images/generations \
  -H "Authorization: Bearer sk-你的令牌" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-image-2","prompt":"一张城市夜景","n":1,"size":"1024x1024","quality":"auto","response_format":"url"}'

# 提交成功示例
{"id":"task_xxx","task_id":"task_xxx","object":"image.task","status":"queued","model":"gpt-image-2"}

curl https://ai.yuyapi.cn/v1/images/tasks/task_xxx \
  -H "Authorization: Bearer sk-你的令牌"

# 轮询成功后再取图
{"id":"task_xxx","task_id":"task_xxx","status":"succeeded","progress":100,"result":{"data":[{"url":"https://example.com/image.png"}]}}

成功状态为 succeeded 或 completed。推荐读取 result.data[0].url，同时兼容 data[0].url、result.url、url。处理中状态 queued / processing / running 需要继续轮询。

图生图必须使用 multipart/form-data，多个参考图重复传 image[]。

curl https://ai.yuyapi.cn/v1/images/edits \
  -H "Authorization: Bearer sk-你的令牌" \
  -F "model=gpt-image-2" \
  -F "prompt=参考这张图生成新图" \
  -F "image=@/path/to/input.jpg"

T香蕉2、T香蕉pro 使用 Gemini 原生异步生图接口：POST /v1beta/models/{model}:generateContent，提交成功后继续轮询 GET /v1/images/tasks/{task_id}。多图参考时把图片 base64 放进 parts[].inlineData.data。

curl https://ai.yuyapi.cn/v1beta/models/T香蕉2:generateContent \
  -H "Authorization: Bearer sk-你的令牌" \
  -H "Content-Type: application/json" \
  -d '{"contents":[{"role":"user","parts":[{"text":"生成一张写实摄影风格的橙色跑车，城市夜景"}]}],"generationConfig":{"responseModalities":["TEXT","IMAGE"],"imageConfig":{"aspectRatio":"16:9","imageSize":"2K"}}}'

视频生成

Sora-v3 使用 POST /v1/video/submit/generate 和 GET /v1/video/fetch/{task_id}。支持文生视频、单图图生视频和首尾帧视频。

curl https://ai.yuyapi.cn/v1/video/submit/generate \
  -H "Authorization: Bearer sk-你的令牌" \
  -H "Content-Type: application/json" \
  -d '{"model":"sora-v3-fast","prompt":"一段电影感视频","duration":8,"metadata":{"modeType":"text2video","ratio":"16:9","enableSound":"on"}}'

curl https://ai.yuyapi.cn/v1/video/fetch/task_xxx \
  -H "Authorization: Bearer sk-你的令牌"

Grok、Omni、Veo、KY、XH、LD、AICOPY 新增视频模型和 Wan 3.0，统一从本站 POST /v1/videos 提交并用 GET /v1/videos/{task_id} 轮询。本站会在服务端按模型选择上游真实路径，调用方不需要也不能使用上游 API key；图片、视频、音频请使用上游可访问的公网 URL。

Wan 3.0 的参数为 model、prompt、duration（2-30 秒）、resolution（480p / 720p / 1080p）、aspect_ratio，可选 images、videos、audios。本站内部会转发到上游 POST /v1/videos/generations，再查询 GET /v1/tasks/{task_id}；两个 Wan 3.0 模型按成功任务固定计费，标准版 `$0.330/次`，高速版 `$0.390/次`。

本次新增的模型也统一使用此接口。Chengmeng 的 sd-2.5-按次 固定生成30秒并按分辨率一次性计费（480p=12/次、720p=16/次、1080p=22/次）；sd-2.5-线路1（2.5） 按分辨率和实际秒数计费（480p=0.40/秒、720p=0.62/秒，最长30秒）；官转-2.5-全分辨率 按分辨率和实际秒数计费（480p=0.5/秒、720p=1.13/秒、1080p=2.8/秒，最长30秒）。其他官方/超分模型按生成秒数计费。提交后先保存 task_id，再轮询任务结果。

curl https://ai.yuyapi.cn/v1/videos \
  -H "Authorization: Bearer sk-你的令牌" \
  -H "Content-Type: application/json" \
  -d '{"model":"omni-flash-components-1080p","prompt":"make the subject walk forward naturally","seconds":"8","images":["https://example.com/input.jpg"],"aspect_ratio":"9:16","n":1}'

# 本次新增模型示例
curl https://ai.yuyapi.cn/v1/videos \
  -H "Authorization: Bearer sk-你的令牌" \
  -H "Content-Type: application/json" \
  -d '{"model":"【超分版】sd2.5-1080p","prompt":"主体自然向前行走","duration":8,"resolution":"1080p","aspect_ratio":"16:9","images":["https://example.com/input.jpg"]}'

curl https://ai.yuyapi.cn/v1/videos/task_xxx \
  -H "Authorization: Bearer sk-你的令牌"