API reference

https://apimk.com

Prefix: /api/v1. JSON over HTTPS unless noted. Uploads use multipart/form-data.

Create keys on the keys page. The full key is shown once, starts with hxsk_, and is about 37 characters — it is not truncated.

Authorization: Bearer hxsk_...

The keys page shows product labels, not API ids. Send the id from GET /api/v1/models. Age confirmation is required before uploads or jobs.

{ "error": { "code": "invalid_sku", "message": "Invalid SKU: video.std" } }

Job creation returns 202. Treat only 2xx bodies as success.

Send the id from GET /api/v1/models, not the keys-page label. SKU must match resolution: 480p → video.fast, 720p → video.std, 1080p → video.pro.

Do not send seedance20, Seedance 2.0, GPT Image 2.5 Sunburst, or any keys-page label. Those are not catalog ids. Always copy id from GET /api/v1/models.

Quote and submit the same params object. Unknown fields return unsupported_field.

Seedance reference stills stay text-to-video. Grok video with a still is image-to-video. i2v needs a first frame or reference image; v2v needs a reference clip.

Quote then submit

curl https://apimk.com/api/v1/quotes \
  -H "Authorization: Bearer hxsk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "sku": "video.std",
    "prompt": "slow push down a rainy alley, neon reflections",
    "params": {
      "model": "doubao-seedance25",
      "mode": "t2v",
      "resolution": "720p",
      "ratio": "16:9",
      "duration": 5
    }
  }'

curl https://apimk.com/api/v1/jobs \
  -H "Authorization: Bearer hxsk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "quote_id": "PASTE_QUOTE_ID",
    "sku": "video.std",
    "prompt": "slow push down a rainy alley, neon reflections",
    "params": {
      "model": "doubao-seedance25",
      "mode": "t2v",
      "resolution": "720p",
      "ratio": "16:9",
      "duration": 5
    }
  }'

Upload and image-to-video

curl https://apimk.com/api/v1/uploads \
  -H "Authorization: Bearer hxsk_..." \
  -F slot=first \
  -F [email protected]

{
  "sku": "video.std",
  "prompt": "the subject walks toward camera, outfit unchanged",
  "params": {
    "model": "grok-imagine-video-1.5",
    "mode": "i2v",
    "resolution": "720p",
    "ratio": "9:16",
    "duration": 5,
    "first_frame_upload_id": "UPLOAD_ID"
  }
}

Poll and download

curl https://apimk.com/api/v1/jobs/JOB_ID \
  -H "Authorization: Bearer hxsk_..."

curl "https://apimk.com/api/v1/jobs/JOB_ID/media?thumb=1" \
  -H "Authorization: Bearer hxsk_..." \
          -o thumb.webp

For integrators that cannot quote then submit. Path is /v1/videos, not /api/v1. Same Authorization: Bearer hxsk_.... The server fills SKU from resolution, quotes, and holds the balance. Use section 8 for the full API.

curl https://apimk.com/v1/videos \
  -H "Authorization: Bearer hxsk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance25",
    "prompt": "slow push down a rainy alley, neon reflections",
    "duration": 10,
    "resolution": "720p",
    "ratio": "16:9",
    "referenceImages": ["https://example.com/img.jpg"],
    "referenceVideos": ["https://example.com/ref.mp4"],
    "referenceAudios": ["https://example.com/ref.mp3"]
  }'

{
  "id": "2f50c75e-...",
  "status": "queued",
  "created_at": 1730000000,
  "quoted_price_usd": 0.45
}

status is queued / processing / succeeded / failed. Create returns both id and job_id. On success both url and result.url are the upstream HTTPS result URL, passed through as-is. It expires and may hit an upstream warning page. The same request retried within about 2 minutes returns the same id.

Insufficient balance returns 400 and creates no job. Seedance 1.x and some models reject reference URLs. Unknown fields are ignored. Local files still need /api/v1/uploads.

1. Create a key and allow the models you need.
2. List models, then upload references if required.
3. Quote, then submit the same prompt, SKU, and params.
4. Poll until succeeded, failed, or rejected.
5. Download result.url. Use ?thumb=1 for posters.

Moderation rejects are not billed. If submit times out, the hold stays — poll the job instead of resubmitting the same quote.