媒体生成 - HCAI

🐭

🐱

💨

汤姆正在追杰瑞...

正在生成中，请稍候

🎨

开始创作

选择生成模式，输入描述词，即可生成精美的图片或视频内容

⬇️ 下载

📖 媒体 API 文档

🔐 认证

媒体接口使用 登录 Token（不是 API Key）。调用 /api/v1/auth/login 获取 Token 后，在请求头中带上：

Authorization: Bearer <your-login-token>

📋 接口总览

方法	路径	说明
POST	/api/v1/media/images/generate	文生图
POST	/api/v1/media/images/edit	图生图 / 局部编辑
POST	/api/v1/media/videos/generate	视频生成
GET	/api/v1/media/tasks/:taskId	查询任务状态
POST	/api/v1/media/upload	上传素材
GET	/api/v1/media/pricing	模型定价
POST	/api/v1/media/estimate	费用预估

🖼️ 文生图示例

curl -X POST https://your-domain.com/api/v1/media/images/generate \ -H "Authorization: Bearer <token>" \ -H "Content-Type: application/json" \ -d '{ "model": "wan2.7-image-pro", "input": { "prompt": "一只橘猫在阳光下打盹" }, "parameters": { "size": "1024*1024", "n": 1 } }'

🎬 视频生成示例

curl -X POST https://your-domain.com/api/v1/media/videos/generate \ -H "Authorization: Bearer <token>" \ -H "Content-Type: application/json" \ -d '{ "model": "wan2.7-t2v", "input": { "prompt": "一只橘猫在清晨的海边奔跑" }, "parameters": { "duration": 5, "resolution": "720P" } }'

🔄 任务轮询

视频生成是异步任务，提交后返回 task_id，需轮询查询状态：

curl "https://your-domain.com/api/v1/media/tasks/{task_id}?model=wan2.7-t2v&resolution=720P&duration=5" \ -H "Authorization: Bearer <token>"

task_status 为 SUCCEEDED 时，output.video_url 即为视频地址。失败不扣费。

💰 计费说明

图片：按张计费，生成成功后立即扣费。
视频：按秒计费（区分 720P/1080P），任务成功后扣费，失败不计费。
缓存：支持阿里云上下文缓存，命中时自动享受输入价折扣，无需额外配置。