将 Imagild 图片与视频模型接入你自己的应用。
API Key 只应保存在服务端环境变量中。不要将完整 Key 提交到代码仓库或暴露在浏览器端。
正在核验权限…
| 名称 | API Key | 状态 | 操作 |
|---|---|---|---|
| 暂无记录 | |||
https://imagild.com/api/relay/v1Authorization: Bearer YOUR_API_KEYAPI 调用仅限有效会员。提交时预留积分,明确失败后释放。 图片与图片生成市场统一计费:1K 10 积分、2K 15 积分、4K 20 积分/张。视频沿用工作台价格,已提交任务保留原报价。
接入指南以下 cURL 示例适用于 Bash / zsh。先将 YOUR_API_KEY 替换为刚刚保存的密钥。
export IMAGILD_API_KEY='YOUR_API_KEY'curl 'https://imagild.com/api/relay/v1/images/generations' \
-H "Authorization: Bearer $IMAGILD_API_KEY" \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: image-demo-0001' \
-d '{"model":"gpt-image-2.5","prompt":"A blue paper boat on calm water","resolution":"1K"}'将 TASK_ID 替换为返回的 data.id,每隔 5 秒查询;data.status 为 succeeded 后再下载。图片下载时将文件名改为 result.png。
curl 'https://imagild.com/api/relay/v1/tasks/TASK_ID' \
-H "Authorization: Bearer $IMAGILD_API_KEY"curl 'https://imagild.com/api/relay/v1/tasks/TASK_ID/content' \
-H "Authorization: Bearer $IMAGILD_API_KEY" \
-o result.png使用 multipart 的 photo 字段上传图片(最多 20MB),将返回的 file_id 填入图片或视频生成请求。也可用已完成图片任务的 image_task_id 作为参考,两个字段不能同时使用。
curl 'https://imagild.com/api/relay/v1/files' \
-H "Authorization: Bearer $IMAGILD_API_KEY" \
-F 'photo=@reference.jpg'生成采用异步任务:POST 返回任务 ID,每隔 5 秒查询一次;status 为 succeeded 后,携带同一 Bearer 密钥下载 output_url。
每次新生成使用新的 Idempotency-Key;同一次生成重试必须使用相同标识和参数,将复用原任务。参数改变返回 409。上游回执不明确时不要更换标识重新提交。
最多 5 个有效密钥。每个账户每分钟最多 10 次生成/上传、120 次读取,超限返回 429。密钥撤销、到期或会员失效后,立即停止访问。
status 为 unknown 时请联系支持核对原任务,不要重复生成。失败任务按网站规则释放预留积分。
提供异步 HTTP API,不使用 OpenAI SDK 的同步图片返回格式。