下面示例覆盖文本、视觉、图片和视频接口。复制后把 YOUR_API_KEY 替换为你的密钥即可运行。
OpenAI Responses 文本+视觉
新一代 OpenAI 接口,适合文本对话、图片理解和流式输出。
POST /v1/responsesOpenAI Chat Completions 文本+视觉
兼容传统 OpenAI Chat 格式,适合已有客户端平滑迁移。
POST /v1/chat/completionsAnthropic Messages 文本+视觉
Claude / Anthropic Messages 格式;图片模式会先转 base64 再提交。
POST /v1/messagesGPT / Gemini 图片生成与编辑
文生图走 /v1/images/generations;图生图和图片编辑走 /v1/images/edits,支持 multipart 本地文件、多张参考图,以及 JSON 的 images[].image_url(图片链接或 data URL)。Gemini(官方直连)分组可直接将示例 model 换成图片生成 使用教程中列出的 Gemini 图片模型 ID,保留 stream=true、n=1、response_format=b64_json。Gemini 返回 usage 和 usageMetadata,图片格式见 mime_type;size 会转换为比例与 1K/2K/4K 档位,实际像素由模型决定,2.5 系列仅支持 1K。Gemini 暂不支持 mask、批量 n>1、强制 output_format 和非 auto 的 quality/background 等参数。
POST /v1/images/generationsgpt-image-2 图片编辑(multipart)
上传图片并按提示修改,通过流式事件保存编辑结果。
POST /v1/images/editsgrok-imagine-video 视频生成
异步视频生成:提交任务拿到 request_id,轮询状态直到完成,再下载视频文件。
POST /v1/videos/generations常见报错:expected struct ImageUrl
若返回 “Failed to deserialize the JSON body into the target type: image: invalid type: string "https://...", expected struct ImageUrl”,说明 image 字段被直接写成了字符串。 正确写法:{"image": {"url": "https://example.com/a.png"}};同时兼容 {"image": {"image_url": "https://example.com/a.png"}}。 错误写法:{"image": "https://example.com/a.png"}。 传本地图片时把 url 换成 data URL,例如 "data:image/png;base64,<BASE64>"。
参数与计费说明
resolution 支持 480p / 720p,duration 默认 8 秒、可选 1–15 秒,按秒计费。 生成为异步任务:/v1/videos/generations 返回 request_id,轮询 GET /v1/videos/{request_id} 得到 status 与 video.url,再用 GET /v1/videos/{request_id}/content 下载视频字节流。 video.url 为临时签名直链,请及时下载保存。