开始

生成视频

POST /v1/videos/generations

生成接口只接收 JSON 和 HTTPS 素材 URL，不接收 Base64、multipart 或本地文件字节。 这套接口同时接受扁平字段和官方/无限画布常用的 content[] 形状。

Miku 视频模型能力

参考数量是图片 / 视频 / 音频的最大数量；总数也受模型能力限制。 Wan 3、MiniMax H3 以及 Seedance 2.0 系列的音频参考需要视觉参考； Seedance 2.5 可以单独使用音频；Omni 不支持音频，视频参考还需要图片或首帧。 具体文件格式、单文件大小和时长还需满足 Miku 上游文档，上传接口会先按媒体类型执行通用大小校验。

本地文件 · 先直传对象存储

curl -X POST https://media-api.argolink.io/v1/media/uploads \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"seedance-2.5","type":"image","content_type":"image/png","size_bytes":123456}'

把文件按响应中的 upload_method 和 upload_headers PUT 到 upload_url，成功后把 media_url 放进下面的生成 JSON。已有公网 HTTPS URL 可直接使用，无需重复上传。

模式一 · 提示词生成视频

curl -X POST https://media-api.argolink.io/v1/videos/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"model":"seedance-2.5","prompt":"海面日出，镜头缓慢推进","aspect_ratio":"16:9","duration":4,"resolution":"480p","n":1}'

模式二 · 首帧图+提示词生成视频

把 media_url 或已有公网图片 URL 放进 start_image.url：

curl -X POST https://media-api.argolink.io/v1/videos/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"model":"seedance-2.5","prompt":"镜头缓慢推进","aspect_ratio":"16:9","duration":4,"resolution":"480p","start_image":{"url":"https://cdn.example/start.png"}}'

模式三 · 多模态参考素材生成视频

图片、视频、音频都使用 HTTPS URL；可用数量和总时长以模型能力为准：

curl -X POST https://media-api.argolink.io/v1/videos/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"model":"seedance-2.5","prompt":"保持角色一致并延续参考视频节奏","aspect_ratio":"16:9","duration":4,"resolution":"480p","reference_images":[{"url":"https://cdn.example/character.png"}],"reference_videos":[{"url":"https://cdn.example/motion.mp4"}],"reference_audios":[{"url":"https://cdn.example/rhythm.mp3"}]}'

首尾帧与参考素材模式互斥。生成请求本身只携带 URL，所以不会被大文件撑大；本地上传限制由上传初始化接口统一校验。

无限画布兼容 · content[]

需要把文本、首尾帧和参考媒体按顺序传入时，使用官方风格的 content[]。媒体项必须是 HTTPS URL，并使用对应的 role：

{
  "model": "seedance-2.5",
  "content": [
    {"type": "text", "text": "保持角色一致，延续参考视频的动作"},
    {"type": "image_url", "role": "reference_image",
     "image_url": {"url": "https://cdn.example/character.png"}},
    {"type": "video_url", "role": "reference_video",
     "video_url": {"url": "https://cdn.example/motion.mp4"}},
    {"type": "audio_url", "role": "reference_audio",
     "audio_url": {"url": "https://cdn.example/rhythm.mp3"}}
  ],
  "aspect_ratio": "16:9",
  "duration": 5,
  "resolution": "720p"
}

下载视频

提交返回的 id 形如 33344f64-4e95-4342-bfa8-e4a5b4e516ed。把它替换掉下面第一行的 换成你的id，其余一个字都不用动：

ID=换成你的id
URL="https://media-api.argolink.io/v1/jobs/$ID/video"
KEY="Authorization: Bearer YOUR_API_KEY"

# 1. 等生成好（只探 1 字节，不写文件）
while [ "$(curl -s -o /dev/null -w '%{http_code}' -r 0-0 "$URL" -H "$KEY")" = 409 ]; do
  echo "生成中…"; sleep 10
done

# 2. 下载：断了自动续传重试，没下全会报错而不是假装成功
curl -f -o 视频.mp4 -C - --retry 5 --retry-delay 3 --retry-all-errors "$URL" -H "$KEY" \
  && echo "已保存 视频.mp4" || echo "下载没完成，重跑这一条会接着下"

网址里的 /v1/jobs/ 是固定不变的接口路径，不要改； 要替换的只有第一行 ID= 后面那一段。

200 存盘退出，409 还在生成继续等，其它情况打印原因后停下—— 任务失败时不会一直空转。

存到哪

-o 后面写什么，就存到哪：

-o 视频.mp4                      # 存到你运行命令的那个目录
-o ~/Downloads/视频.mp4          # 存到「下载」文件夹
-o /Users/你的用户名/Desktop/片.mp4   # 存到桌面（写完整路径）
-o "$ID.mp4"                     # 用任务 id 当文件名，批量下载不会重名

Nano Banana 生成图片

POST /v1/images/generations

提示词生成图片

curl -X POST https://media-api.argolink.io/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"model":"nano-banana-2-lite","prompt":"一只橘猫坐在窗边，晨光，写实摄影","aspect_ratio":"4:3","n":1,"output_format":"jpeg"}'

三个模型由 MediaRelay 按模型能力、账号 Priority、固定出口、RPM 和并发 自动选择执行账号；只需替换 model，不需要另一把 Key。

参考图生成图片

POST /v1/images/edits

当前经过验证的 Flow 契约是每个请求最多 10 张参考图。支持 PNG 和 JPEG， 单张 ≤5MB、≤2500 万像素；图片会上传到该账号当前的同一个 Flow 工作项目。

curl -X POST https://media-api.argolink.io/v1/images/edits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -F model=nano-banana-2 \
  -F prompt=保留主体外观，把背景改成雨夜霓虹街道 \
  -F aspect_ratio=4:3 \
  -F n=1 \
  -F output_format=jpeg \
  -F "image[]=@参考图1.png;type=image/png" \
  -F "image[]=@参考图2.png;type=image/png"

JSON 请求可使用 {"image":[{"url":"https://..."}]} 或 {"image":[{"data_url":"data:image/png;base64,..."}]}； multipart/form-data 可重复提交 image 或 image[]。每个请求最多 10 张参考图。设置 n 为 2–4 时会基于同一组参考图独立生成对应张数。

保存图片结果

提交接口返回任务 id。查询 /v1/jobs/{id}，直到 status 为 succeeded 或 partial；图片位于 result.data[].b64_json，内容是原始 JPEG。

ID=换成你的id
BODY=""

while true; do
  BODY="$(curl -fsS "https://media-api.argolink.io/v1/jobs/$ID" \
    -H "Authorization: Bearer YOUR_API_KEY")" || exit 1
  STATUS="$(printf '%s' "$BODY" | jq -r '.status')"
  case "$STATUS" in
    succeeded|partial) break ;;
    failed|cancelled) printf '%s\n' "$BODY"; exit 1 ;;
    *) echo "生成中…"; sleep 3 ;;
  esac
done

printf '%s' "$BODY" | jq -r '.result.data[0].b64_json' \
  | openssl base64 -d -A > banana.jpg
echo "已保存 banana.jpg"

请求失败不会静默：任务会进入 failed，查询结果会带 error 对象，其中 code 是稳定的失败码，message 说明原因，retryable 为 true 表示这次失败没有产生生成费用，可以直接重新提交，参数问题还会带 field。脚本遇到失败会打印完整任务状态并退出。

错误码

错误响应统一是 {"error":{"code":"..."}}。 402 与 429 可恢复，其余需要改请求。