接口选择与兼容性

先确认模型支持的端点,再使用对应协议、请求路径和请求体。

先做这一步

cURL
curl "https://ikun.love/v1/models" \
  -H "Authorization: Bearer sk-your-api-key"

只使用返回的模型 ID。模型必须支持准备调用的接口;能聊天不代表能生成图片、向量、音频或视频。

怎么选接口

需求接口
普通文字聊天Chat Completions
推理、工具调用、CodexResponses
Claude CodeClaude Messages
Gemini CLI 或 Gemini 原生 SDKGemini 原生接口
旧版文本续写Completions
图片生成或编辑Images
异步视频Videos

OpenAI 格式的模型列表会返回 supported_endpoint_types。优先选择同时出现在模型列表和请求路径中的能力,不要仅凭模型名称猜测接口支持情况。

官方参数文档

本站只说明本站地址和最小请求,完整参数以官方文档为准。

协议不要混用

  • Chat 请求体不能直接发送到 Responses、Claude 或 Gemini 路径。
  • Claude Code 使用服务根地址;OpenAI SDK 通常使用带 /v1 的地址。
  • 图片编辑、音频转写、音频翻译和视频创建使用 multipart/form-data。
  • Realtime 使用 WebSocket。
  • /v1/responses/compact 只用于明确支持该端点的 OpenAI/Codex 模型。
  • /v1/edits 当前按图片编辑处理。

专用任务路径

以下任务接口统一使用 Authorization: Bearer sk-your-api-key,请求体按对应服务格式填写。

服务路径
Kling 文生视频POST /kling/v1/videos/text2video
Kling 图生视频POST /kling/v1/videos/image2video
MidjourneyPOST /mj/submit/{action}
SunoPOST /suno/submit/{action}
即梦POST /jimeng/

常见错误

错误先检查
401API Key、请求头、Base URL
400模型 ID、路径、必填字段、请求体格式
404是否重复或遗漏 /v1,模型或任务 ID 是否正确
403API Key 的模型、IP、分组权限
429余额、额度、速率限制和上游负载

收到 200 但业务结果失败时,继续查看响应体中的 error 或任务状态;异步视频、Kling、Midjourney、Suno 和即梦需要先提交任务,再轮询任务结果。