登录
文档多模态接口

多模态接口

图片、音频、重排序、内容审核、Realtime 和异步视频的本站路径与最小请求。

开始调用前，先用 GET /v1/models 确认模型 ID，再确认该模型支持目标能力。模型能完成文本对话，不代表同时支持图片、音频或视频。

图片

官方文档： OpenAI Images API

生成

使用 POST /v1/images/generations。

cURL
curl "https://ikun.love/v1/images/generations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"model":"your-image-model-id","prompt":"一座湖边的山，日出","n":1,"size":"1024x1024"}'

编辑

使用 POST /v1/images/edits，提交图片时使用 multipart/form-data。/v1/edits 也可作为图片编辑兼容路径。

cURL
curl "https://ikun.love/v1/images/edits" \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "model=your-image-model-id" \
  -F "prompt=把天空改成日落" \
  -F "image=@input.png"

音频

官方文档： OpenAI Audio API

转写

使用 POST /v1/audio/transcriptions，字段通过 multipart/form-data 上传。

cURL
curl "https://ikun.love/v1/audio/transcriptions" \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "file=@audio.mp3" \
  -F "model=your-audio-model-id"

翻译

将转写路径改为 POST /v1/audio/translations，其余鉴权方式保持不变。

文本转语音

使用 POST /v1/audio/speech，响应是音频内容，建议直接保存到文件。

cURL
curl "https://ikun.love/v1/audio/speech" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"model":"your-tts-model-id","input":"欢迎使用 API","voice":"alloy","response_format":"mp3"}' \
  --output speech.mp3

重排序

使用 POST /v1/rerank。请求体至少包含 model、query 和 documents。

cURL
curl "https://ikun.love/v1/rerank" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"model":"your-rerank-model-id","query":"API 鉴权","documents":["文档 A","文档 B"],"top_n":2}'

内容审核

官方文档： OpenAI Moderations API

使用 POST /v1/moderations，请求体包含 model 和 input。

cURL
curl "https://ikun.love/v1/moderations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"model":"your-moderation-model-id","input":"需要审核的文本"}'

Realtime

官方文档： OpenAI Realtime API

WebSocket 地址
wss://ikun.love/v1/realtime?model=your-realtime-model-id

使用 WebSocket 客户端连接。浏览器不能自定义 Authorization 时，可在握手时传递以下子协议：

WebSocket 握手头
Sec-WebSocket-Protocol: realtime, openai-insecure-api-key.sk-your-api-key, openai-beta.realtime-v1

服务端返回的事件格式和会话流程以官方 Realtime 文档为准。

视频

官方文档： OpenAI Videos API

创建任务使用 POST /v1/videos，查询使用 GET /v1/videos/{video_id}，下载使用 GET /v1/videos/{video_id}/content。

创建任务
curl "https://ikun.love/v1/videos" \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "model=your-video-model-id" \
  -F "prompt=A cinematic sunrise over a city" \
  -F "seconds=8"
查询和下载
curl "https://ikun.love/v1/videos/video_task_xxx" \
  -H "Authorization: Bearer sk-your-api-key"

curl -L "https://ikun.love/v1/videos/video_task_xxx/content" \
  -H "Authorization: Bearer sk-your-api-key" \
  --output result.mp4

只有任务状态为 completed 时下载内容。Kling、Midjourney、Suno 和即梦使用各自的任务接口，路径见 兼容性与限制。