1. Choose a mode and references in the workspace
Sign in and open Video. Select the model, mode, resolution, duration and ratio. Upload references if required, then obtain a quote. Changing parameters invalidates the quote. Check the cost and balance before submitting.
| Mode | References |
|---|---|
| text | No references |
| image | One first_frame image |
| frames | One first_frame and one last_frame image |
| avatar | One reference_image; optional reference_audio |
| reference | Up to 9 images, 3 videos and 3 audio references |
2. Check parameters and upload limits
H3 supports 4–15 seconds and 720P / 1080P / 2K. Ratios are adaptive, 21:9, 16:9, 4:3, 1:1, 3:4 and 9:16. Check the model catalog for available rates and combinations. Declared parameters are not exhaustive test results.
- JPG/PNG and MP3/WAV: at most 3,000,000 bytes. MP4: at most 5,000,000 bytes. Image width and height must each be 256–5760 pixels.
- The browser attempts image resizing. API clients must prepare compliant images before uploading. Use your own unexpired ref IDs, not remote material URLs.
- Submit only materials you may use and follow the content rules.
3. Read the catalog and obtain an API quote
Use your AK47Token API Key with Authorization: Bearer. Read GET /v1/videos/models for currently available models and rates. If needed, upload multipart file to POST /v1/videos/references. This text-only quote uses AK47_API_KEY supplied through your own secure environment. Quotes normally last 5 minutes and do not charge generation fees.
curl https://ak47token.com/v1/videos/quotes \
-H "Authorization: Bearer $AK47_API_KEY" \
-H 'Content-Type: application/json' \
-d '{"model":"minimax-h3","mode":"text","prompt":"A blue robot waves.","duration":4,"resolution":"720P","ratio":"16:9"}'4. Create a task with identical parameters
Put the returned quote ID in quote_id and keep the model, prompt, mode, duration, resolution, ratio and references identical. Choose one unique Idempotency-Key for this generation. Successful creation returns 202. The following request starts real generation and reserves credit according to the quote.
- Keep the original key and parameters when checking or retrying after a network error. Do not use a new key to submit the same generation again.
- Reusing a key with different parameters returns 409. An expired quote or changed parameters requires a new quote.
curl https://ak47token.com/v1/videos \
-H "Authorization: Bearer $AK47_API_KEY" \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: REPLACE_WITH_YOUR_UNIQUE_REQUEST_ID' \
-d '{"model":"minimax-h3","mode":"text","prompt":"A blue robot waves.","duration":4,"resolution":"720P","ratio":"16:9","quote_id":"REPLACE_WITH_QUOTE_ID"}'5. Inspect the task, check charges and download
GET /v1/videos/:id reads your task. Once it succeeds and billing finishes, download the private MP4 with GET /v1/videos/:id/content?download=1. Use the original API Key or your browser session. Generated outputs are saved permanently. View, download or delete them at any time.
| State | Action |
|---|---|
| pending / queued / submitting / running / archiving | Keep checking the original task; do not regenerate |
| succeeded with settled billing | Download and check parameters and charges |
| failed with reserved billing | Wait for the refund status to become refunded |
| submission_unknown / review_required | Keep the task ID and contact support for reconciliation |
- Settlement uses the video rate and confirmed duration. One bullet is 1,000,000 units; 440000 units equals CNY 0.44.
- The 2026-10-18 four-second test produced a roughly 4.458-second MP4 container and was billed for four confirmed seconds. Do not round container duration yourself.
- For support, provide the task ID, time, model and redacted error, never an API Key or cookie.