Get started with WanAPIs

curl https://api.wanapis.com/v1/images/tasks \
                -H "Authorization: Bearer $WANAPIS_API_KEY" \
                -H "Content-Type: application/json" \
                -d '{
                  "model": "midjourney",
                  "prompt": "a small red apple on a white table --ar 1:1 --q .25"
                }'

curl https://api.wanapis.com/v1/images/tasks \
                -H "Authorization: Bearer $WANAPIS_API_KEY" \
                -H "Content-Type: application/json" \
                -d '{
                  "model": "midjourney",
                  "prompt": "turn this into watercolor style --ar 1:1",
                  "image_urls": ["https://example.com/source.jpg"]
                }'

{
  "code": "success",
  "data": {
    "task_id": "task_xxxxxxxxxxxxxxxxxxxxxxxxxx",
    "status": "SUCCESS",
    "progress": "100%",
    "data": {
      "code": 200,
      "data": {
        "status": "completed",
        "result": {
          "images": [
            {
              "url": ["https://.../image.png"],
              "expires_at": 1784819826
            }
          ]
        }
      }
    }
  }
}

curl https://api.wanapis.com/v1/images/tasks \
  -H "Authorization: Bearer $WANAPIS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.5-flare",
    "prompt": "a plain white ceramic mug on a white table, product photo",
    "size": "1:1",
    "quality": "low",
    "resolution": "1k"
  }'

curl https://api.wanapis.com/v1/images/tasks \
  -H "Authorization: Bearer $WANAPIS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.5-sunburst",
    "prompt": "replace the background with a clean white studio",
    "image_urls": ["https://example.com/source.jpg"],
    "quality": "low"
  }'
# Use sunburst for editing. Polling works the same as the other async models,
# and result URLs expire after about 24 hours.

curl https://api.wanapis.com/v1/images/tasks \
  -H "Authorization: Bearer $WANAPIS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen-image-2.0",
    "prompt": "a plain white ceramic mug on a white table, product photo",
    "size": "16:9"
  }'
# => {"code":"success","data":{"status":"submitted","task_id":"task_xxx"}}

curl https://api.wanapis.com/v1/images/tasks \
  -H "Authorization: Bearer $WANAPIS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen-image-2.0",
    "prompt": "turn this photo into a watercolor painting",
    "image_urls": ["https://example.com/source.jpg"]
  }'
# The reference image must be reachable from the public internet; inline
# data:image/png;base64,... images work too.
# For editing tasks, flux-kontext-pro stays closer to the source image.

curl https://api.wanapis.com/v1/images/tasks/task_xxx \
  -H "Authorization: Bearer $WANAPIS_API_KEY"
# Poll every 3-5 seconds; most jobs finish in 10-30 seconds.
# Once status is SUCCESS, image URLs live at data.data.data.result.images[].url[]
# Those URLs expire after ~24h, so download and store them promptly.

curl https://api.wanapis.com/v1/video/generations \
  -H "Authorization: Bearer $WANAPIS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-v3",
    "prompt": "a cat walking through a neon-lit alley, cinematic",
    "mode": "pro",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

curl https://api.wanapis.com/v1/video/generations \
  -H "Authorization: Bearer $WANAPIS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-h3",
    "prompt": "a white kitten chases a butterfly across a sunlit garden, gentle camera tracking",
    "size": "1280x720",
    "seconds": "4"
  }'

curl https://api.wanapis.com/v1/video/generations \
  -H "Authorization: Bearer $WANAPIS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-h3",
    "prompt": "the camera slowly pushes in, petals drifting past",
    "input_reference": {"image_url": "https://example.com/first.jpg"},
    "size": "1280x720",
    "seconds": "4"
  }'

curl https://api.wanapis.com/v1/video/generations \
  -H "Authorization: Bearer $WANAPIS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-h3-max",
    "prompt": "slow cinematic push in",
    "image_url": "https://example.com/first.jpg",
    "end_image_url": "https://example.com/last.jpg",
    "resolution": "768P",
    "duration": 5
  }'

curl https://api.wanapis.com/v1/video/generations \
  -H "Authorization: Bearer $WANAPIS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-h3-max",
    "prompt": "the character in image 1 walks through the alley in image 2, moving like the clip",
    "reference_image_urls": ["https://example.com/character.jpg", "https://example.com/alley.jpg"],
    "reference_video_urls": ["https://example.com/motion.mp4"],
    "resolution": "768P",
    "duration": 10
  }'

curl https://api.wanapis.com/v1/video/generations \
  -H "Authorization: Bearer $WANAPIS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-video",
    "prompt": "a paper plane glides over a neon city at night",
    "seconds": "6"
  }'

curl https://api.wanapis.com/v1/video/generations \
  -H "Authorization: Bearer $WANAPIS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-video",
    "prompt": "slow cinematic push in",
    "seconds": "6",
    "reference_images": ["https://example.com/first.jpg"]
  }'

curl https://api.wanapis.com/v1/video/generations \
  -H "Authorization: Bearer $WANAPIS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video",
    "prompt": "a paper plane glides over a neon city at night",
    "duration": 6,
    "resolution": "720p"
  }'

curl https://api.wanapis.com/v1/video/generations \
  -H "Authorization: Bearer $WANAPIS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video-1.5",
    "prompt": "slow cinematic push in",
    "duration": 6,
    "resolution": "1080p",
    "reference_images": ["https://example.com/first.jpg"]
  }'

curl https://api.wanapis.com/v1/video/generations \
  -H "Authorization: Bearer $WANAPIS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0",
    "prompt": "Smoothly transition from a daytime city street to a neon-lit night street, camera moving forward",
    "seconds": "5",
    "metadata": {
      "resolution": "720p",
      "ratio": "16:9",
      "content": [
        {"type": "image_url", "role": "first_frame", "image_url": {"url": "https://example.com/day.jpg"}},
        {"type": "image_url", "role": "last_frame", "image_url": {"url": "https://example.com/night.jpg"}}
      ]
    }
  }'

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "task_xxxxxxxxxxxxxxxxxxxxxxxxxx",
    "status": "SUCCESS",
    "progress": "100%",
    "result_url": "https://api.wanapis.com/v1/videos/task_xxxxxxxxxxxxxxxxxxxxxxxxxx/content",
    "fail_reason": "",
    "quota": 234000,
    "submit_time": 1790087400,
    "start_time": 1790087406,
    "finish_time": 1790087421,
    "properties": {
      "origin_model_name": "minimax-h3",
      "upstream_model_name": "MiniMax-H3"
    },
    "data": { "...": "上游原始响应,字段随模型而异" }
  }
}