開発ドキュメント

https://api.fastart.ai/enterprise/fastart/v1

curl --fail-with-body "https://api.fastart.ai/enterprise/fastart/v1/models" \
  -H "Authorization: Bearer $FASTART_KEY"

import os, time
import requests

base = "https://api.fastart.ai/enterprise/fastart/v1"
headers = {"Authorization": "Bearer " + os.environ["FASTART_KEY"]}
# Choose model, capability, mode and parameter values from GET /models.
payload = {
    "model": "qwen-image-2-1",
    "capability": "text_to_image",
    "parameters": {"prompt": "A golden retriever on green grass.", "aspect_ratio": "16:9"},
}
response = requests.post(base + "/generations", json=payload,
    headers=headers, timeout=180)
response.raise_for_status()
task_id = response.json()["task"]["id"]
deadline = time.monotonic() + 3600
while time.monotonic() < deadline:
    response = requests.get(base + "/generations/" + task_id, headers=headers, timeout=30)
    if response.status_code == 429 or response.status_code >= 500:
        time.sleep(15)
        continue
    response.raise_for_status()
    task = response.json()["task"]
    print(task["status"], task["progress"])
    if task["status"] == "succeeded":
        print(task["outputs"])  # Signed URLs can be downloaded without a browser cookie.
        break
    if task["status"] in ("failed", "cancelled"):
        raise RuntimeError(task["error"] or task["status"])
    time.sleep(5)
else:
    raise TimeoutError("Keep task_id and query later; do not create another task.")

{
  "task": {
    "id": "00000000-0000-4000-8000-000000000001",
    "model": "qwen-image-2-1",
    "capability": "text_to_image",
    "mode": "generate",
    "status": "succeeded",
    "progress": 100,
    "outputs": [
      {
        "asset_id": "00000000-0000-4000-8000-000000000002",
        "type": "image",
        "url": "https://assets.example.com/signed/result.png",
        "mime_type": "image/png",
        "metadata": {
          "width": 1328,
          "height": 1328
        }
      }
    ],
    "error": null,
    "billing_status": "settled",
    "usage": {
      "reserved_microcredits": 1000,
      "consumed_microcredits": 1000,
      "released_microcredits": 0
    }
  }
}

https://api.fastart.ai/enterprise/minimax/v1

curl --fail-with-body -X POST "https://api.fastart.ai/enterprise/minimax/v1/video_generation" \
  -H "Authorization: Bearer $FASTART_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "MiniMax-H3",
  "content": [
    {
      "type": "text",
      "text": "A golden retriever running on green grass."
    }
  ],
  "resolution": "352P",
  "duration": 3,
  "ratio": "16:9"
}'

Authorization: Bearer <FASTART_KEY>
Content-Type: application/json

{
  "task_id": "00000000-0000-4000-8000-000000000001"
}

curl --fail-with-body -X GET "https://api.fastart.ai/enterprise/minimax/v1/query/video_generation/${FASTART_TASK_ID}" \
  -H "Authorization: Bearer $FASTART_KEY"

{
  "task": {
    "id": "00000000-0000-4000-8000-000000000001",
    "model": "MiniMax-H3",
    "status": "succeeded",
    "created_at": 1789120000,
    "updated_at": 1789120030,
    "resolution": "352P",
    "duration": 3,
    "ratio": "16:9",
    "task_type": "generation",
    "modality": "video",
    "content": {
      "url": "https://assets.example.com/output.mp4?signature=EXAMPLE"
    },
    "usage": {
      "total_seconds": 3,
      "input_seconds": 0,
      "output_seconds": 3,
      "input_image_count": 0
    }
  }
}

{
  "task": {
    "id": "00000000-0000-4000-8000-000000000001",
    "model": "MiniMax-H3",
    "status": "failed",
    "created_at": 1789120000,
    "updated_at": 1789120030,
    "resolution": "352P",
    "duration": 3,
    "ratio": "16:9",
    "task_type": "generation",
    "modality": "video",
    "error": {
      "code": "1000",
      "message": "video generation failed"
    }
  }
}

import os
import time
from urllib.parse import quote
import requests

task_id = quote(os.environ["FASTART_TASK_ID"], safe="")
headers = {"Authorization": "Bearer " + os.environ["FASTART_KEY"]}
deadline = time.monotonic() + 1800  # Client wait limit, not a server timeout

while time.monotonic() < deadline:
    response = requests.get(
        f"https://api.fastart.ai/enterprise/minimax/v1/query/video_generation/{task_id}",
        headers=headers, timeout=30,
    )
    if response.status_code == 429 or response.status_code >= 500:
        time.sleep(15)  # Retry this GET only; never resubmit POST
        continue
    response.raise_for_status()
    task = response.json()["task"]
    print(task["status"])
    if task["status"] == "succeeded":
        print(task["content"]["url"])
        break
    if task["status"] in ("failed", "cancelled"):
        raise RuntimeError(task.get("error", task["status"]))
    time.sleep(5)
else:
    raise TimeoutError("Keep task_id and query later; do not resubmit.")

curl --fail-with-body -X DELETE "https://api.fastart.ai/enterprise/minimax/v1/video_generation/${FASTART_TASK_ID}" \
  -H "Authorization: Bearer $FASTART_KEY"

{
  "task_id": "00000000-0000-4000-8000-000000000001",
  "action": "cancelled",
  "status": "cancelled"
}

curl --fail-with-body -X POST "https://api.fastart.ai/enterprise/minimax/v1/video_generation" \
  -H "Authorization: Bearer $FASTART_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "MiniMax-H3",
  "content": [
    {
      "type": "text",
      "text": "A golden retriever running on grass. Use the two reference images for its appearance."
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://assets.example.com/reference-1.jpg"
      },
      "role": "reference_image"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://assets.example.com/reference-2.jpg"
      },
      "role": "reference_image"
    }
  ],
  "resolution": "352P",
  "duration": 3,
  "ratio": "16:9"
}'

curl --fail-with-body -X POST "https://api.fastart.ai/enterprise/minimax/v1/video_generation" \
  -H "Authorization: Bearer $FASTART_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "MiniMax-H3",
  "content": [
    {
      "type": "text",
      "text": "A golden retriever running on grass, guided by the reference motion and audio."
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://assets.example.com/reference.jpg"
      },
      "role": "reference_image"
    },
    {
      "type": "video_url",
      "video_url": {
        "url": "https://assets.example.com/reference.mp4"
      },
      "role": "reference_video"
    },
    {
      "type": "audio_url",
      "audio_url": {
        "url": "https://assets.example.com/reference.wav"
      },
      "role": "reference_audio"
    }
  ],
  "resolution": "352P",
  "duration": 3,
  "ratio": "16:9"
}'

https://assets.example.com/reference.jpg
data:image/png;base64,<BASE64_DATA>
data:video/mp4;base64,<BASE64_DATA>
data:audio/wav;base64,<BASE64_DATA>
mm_file://<FASTART_ASSET_UUID>

{
  "challenge": "ECHO_THIS_VALUE"
}

{
  "type": "error",
  "error": {
    "type": "bad_request_error",
    "message": "media url is required (2013)",
    "http_code": "400"
  },
  "request_id": "00000000000000000000000000000001"
}