模型调用 API 参考

模型调用 API 参考

按模型能力与平台组织的调用文档。先确认模型 ID 和协议,再查看对应接口的参数、返回结构与流式事件。

可靠调用的最短路径

  1. 发现模型:调用 GET /v1/models,使用返回的完整 data[].id,不要照抄页面示例中的固定模型名。
  2. 选择协议:新 OpenAI 集成优先确认 /v1/responses;已有客户端若只支持 Chat Completions,再使用 /v1/chat/completions
  3. 解析结果:Responses 读取 output / response.output_text;Chat Completions 读取 choices[].message;两者不能混用。
  4. 处理状态:除 HTTP 状态码外,还要检查业务状态、完成原因、错误字段和流式结束事件。
curl https://top.qingyuntop.ai/v1/models \
  -H "Authorization: Bearer ${QINGYUN_TOP_API_KEY}"

MJ / Midjourney 调用链

MJ 不使用 Responses 或 Chat Completions 的 output/choices 返回结构,而是独立的异步任务协议。所有 MJ 请求都使用 Authorization Header,并通过 /mj 路径提交和查询任务。

  1. 提交:调用 Imagine、Blend、Describe、Video 或 Edit 等接口,检查返回体 code,保存 result 任务 ID。
  2. 等待:GET /mj/task/{id}/fetch 轮询,或配置 notifyHook 接收任务变化;客户端必须设置间隔、总超时和幂等处理。
  3. 处理:SUCCESS 读取 imageUrl/imageUrlsFAILURE 读取 failReasonMODAL 使用 Modal;需要 U/V/Reroll 时从 buttons[].customId 发起 Action。
curl -X POST https://top.qingyuntop.ai/mj/submit/imagine \
  -H "Authorization: Bearer ${QINGYUN_TOP_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"botType":"MID_JOURNEY","prompt":"a cat in a red jacket"}'

接口目录来源快照:2026-08-19T16:57:52.234Z。MJ/Midjourney 的异步任务字段同时融合自 MJ Apifox 文档。服务端的模型、协议和参数支持可能按账号与渠道变化;正式上线前请用目标 API Key 重新验证。

聊天(Chat)71
ChatGpt 接口27
Anthropic Claude 接口14
谷歌Gemini 接口30
聊天(Responses)8
绘画模型52
视频模型56
luma 视频生成5
Runway 视频生成3
豆包 视频生成8
sora 视频生成16
grok 视频生成5
通义万象 视频生成2
腾讯AIGC视频生成4
豆包 视频生成(官)1
veo 视频生成7
海螺 视频生成5
GPTs 相关2
文生音乐 Suno24
可灵 Kling 平台51
Replicate 聚合平台34
MiniMax官方12
Vidu 官方视频生成、图片生成、音频生成10
Fal-ai 聚合平台29
Rerank 重排序模型1