快速开始
用 Magick API 完成首个文本、图片与视频请求
Magick API 官方开发文档
欢迎使用 Magick API。本页基于整理后的源文档，给出一条最短接入路径，帮助你完成第一次调用。
提示：你只需要更换为Magick API 的域名和API KEY即可一键迁移，0代码修改！
- 域名："https://api.magickapi.com" , 完美兼容OpenAI风格接口
- API KEY: 在后台生成
第一步：获取 API Key
- 打开 API Key 管理页面。
- 登录账号并创建新的 API Key。
- 妥善保存密钥，后续调用时通过
Authorization: Bearer YOUR_API_KEY传入。
第二步：选择接口类型
文本和多数图片接口通常同步返回结果；视频接口采用异步任务模式，提交成功后会返回 id / task_id。
第三步：发送请求
文本生成示例
curl -X POST https://api.magickapi.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5",
"messages": [
{
"role": "user",
"content": "帮我调查并推荐一个最适合编码的大模型"
}
]
}'图像生成示例
curl -X POST https://api.magickapi.com/v1/images/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "可爱的猫咪坐在劳斯莱斯后座上哭",
"size": "1:1",
"n": 1
}'视频生成示例
curl -X POST https://api.magickapi.com/v1/videos \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "veo-3.1-fast-generate-preview",
"prompt": "一个小女孩坐在窗台欣赏春风吹动的柳树",
"duration": 8,
"size": "1280x720"
}'第四步：查询任务状态
视频接口返回 id / task_id 后，可通过 OpenAI 兼容的视频任务接口轮询结果：
curl -X GET https://api.magickapi.com/v1/videos/YOUR_TASK_ID \
-H "Authorization: Bearer YOUR_API_KEY"任务完成后，可下载视频内容：
curl -L https://api.magickapi.com/v1/videos/YOUR_TASK_ID/content \
-H "Authorization: Bearer YOUR_API_KEY" \
--output output.mp4建议提交后等待 5 到 10 秒再开始轮询，之后每 3 到 5 秒查询一次。
下一步
- 文本对话接口：从通用对话接口(默认流式)开始。
- OpenAI Responses：阅读 OpenAI Responses 多模态接口。
- 图像生成：阅读 GPT-Image-2 图像生成。
- 视频生成：阅读 VEO3 视频生成。
最后更新于