Alibaba: HappyHorse-1.0 (Text to Video) API Reference

About

Generate 1080p video with synchronized native audio from a text prompt. Aspect ratios: 16:9, 9:16, 1:1, 4:3, 3:4. Duration: 3–15s.

1. Calling the API

Setup your API Key

To begin using Infron, you first need to create an account and generate your API Key.

Once you have your API key, set it as an environment variable in your runtime environment. This allows your applications to securely access Infron’s API.

export INFRON_KEY="YOUR_API_KEY"

Submit a request

For long-running requests, you can poll for results.

curl https://media.onerouter.pro/v1/videos/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d @- <<'EOF'
{
  "model": "happyhorse/happyhorse1.0/text-to-video",
  "prompt": "Shot 1 (wide, 0-1.5s): A man in a charcoal wool sweater stands at a tall window in a quiet living room, looking out at an overcast afternoon street, soft diffused grey light, warm wood and leather interior, dust drifting in the air.Shot 2 (mid close up, 1.5-3.5s): He turns and sits down into a leather armchair beside the window, opens a worn paperback in his lap, and starts to read, the leather creaking softly under him.Shot 3 (over the shoulder, 3.5-5s): The camera glides slowly over his shoulder down onto the open book, his thumb gently turning a single page, soft window light falling across the paper, shallow depth of field on his hand.",
  "duration": 5,
  "resolution": "1080P",
  "aspect_ratio": "16:9",
  "seed": 12345,
  "n": 1
}
EOF

Response with queue task id

The response will look like this:

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "0c2231f16743453081e5b774c1e192ee",
    "object": "video",
    "model": "happyhorse/happyhorse1.0/text-to-video",
    "status": "created",
    "urls": {
      "query": "https://media.onerouter.pro/v1/videos/tasks/0c2231f16743453081e5b774c1e192ee"
    },
    "created_at": "2026-06-23 11:16:51.52"
  }
}

Fetch request status

You can fetch the status of a request to check if it is completed or still in progress.

curl https://media.onerouter.pro/v1/videos/tasks/{task_id} \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" 

# For example
curl https://media.onerouter.pro/v1/videos/tasks/0c2231f16743453081e5b774c1e192ee \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response with queue task status query

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "0c2231f16743453081e5b774c1e192ee",
    "object": "video",
    "model": "happyhorse/happyhorse1.0/text-to-video",
    "status": "in_progress",
    "fail_reason": "",
    "submit_time": 1782213412,
    "start_time": 1782213411,
    "finish_time": 0,
    "outputs": [],
    "created_at": "2026-06-23 11:16:52"
  }
}

Possible statuses:

• created
• in_progress
• processing
• completed
• failed

created -> in_progress → processing → completed | failed

Poll every 1-2 seconds until status is "completed" or "failed"

Get the result (when status is "completed")

Once the request is completed, you can fetch the result. See the Output Schema for the expected result format.

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "0c2231f16743453081e5b774c1e192ee",
    "object": "video",
    "model": "happyhorse/happyhorse1.0/text-to-video",
    "status": "completed",
    "fail_reason": "",
    "submit_time": 1782213412,
    "start_time": 1782213411,
    "finish_time": 1782213606,
    "outputs": [
      "https://storage.googleapis.com/infron_gcs/video%2Fvideo_v2%2Foutput%2Foutput_f21f09d0-6bc8-4e3d-b733-ca49fdea9c64.mp4"
    ],
    "usage": {
      "completion_tokens": 0,
      "duration": 5,
      "generate_audio": false,
      "output_count": 1,
      "prompt_tokens": 1,
      "request_num": 1,
      "resolution": "1080P",
      "tokens": 1,
      "total_tokens": 1,
      "video_duration": 5
    },
    "cost": {
      "total_cost": 1.10017,
      "cost_details": {
        "prompt_cost": 0,
        "completion_cost": 0,
        "image_cost": 0,
        "video_cost": 1.10017,
        "audio_cost": 0,
        "native_web_search_cost": 0,
        "plugin_web_search_cost": 0,
        "tools_cost": 0,
        "prompt_cache_read_cost": 0,
        "prompt_cache_write_cost": 0,
        "prompt_cache_write_5_min": 0,
        "prompt_cache_write_1_h": 0,
        "reasoning_cost": 0,
        "discount_rate": 1,
        "is_byok": false,
        "byok_cost": 0
      }
    },
    "created_at": "2026-06-23 11:16:52"
  }
}

2. Schema

Input

Example request

curl https://media.onerouter.pro/v1/videos/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d @- <<'EOF'
{
  "model": "happyhorse/happyhorse1.0/text-to-video",
  "prompt": "Shot 1 (wide, 0-1.5s): A man in a charcoal wool sweater stands at a tall window in a quiet living room, looking out at an overcast afternoon street, soft diffused grey light, warm wood and leather interior, dust drifting in the air.Shot 2 (mid close up, 1.5-3.5s): He turns and sits down into a leather armchair beside the window, opens a worn paperback in his lap, and starts to read, the leather creaking softly under him.Shot 3 (over the shoulder, 3.5-5s): The camera glides slowly over his shoulder down onto the open book, his thumb gently turning a single page, soft window light falling across the paper, shallow depth of field on his hand.",
  "duration": 5,
  "resolution": "1080P",
  "aspect_ratio": "16:9",
  "seed": 12345,
  "n": 1
}
EOF

Output

Example output

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "0c2231f16743453081e5b774c1e192ee",
    "object": "video",
    "model": "happyhorse/happyhorse1.0/text-to-video",
    "status": "completed",
    "fail_reason": "",
    "submit_time": 1782213412,
    "start_time": 1782213411,
    "finish_time": 1782213606,
    "outputs": [
      "https://storage.googleapis.com/infron_gcs/video%2Fvideo_v2%2Foutput%2Foutput_f21f09d0-6bc8-4e3d-b733-ca49fdea9c64.mp4"
    ],
    "usage": {
      "completion_tokens": 0,
      "duration": 5,
      "generate_audio": false,
      "output_count": 1,
      "prompt_tokens": 1,
      "request_num": 1,
      "resolution": "1080P",
      "tokens": 1,
      "total_tokens": 1,
      "video_duration": 5
    },
    "cost": {
      "total_cost": 1.10017,
      "cost_details": {
        "prompt_cost": 0,
        "completion_cost": 0,
        "image_cost": 0,
        "video_cost": 1.10017,
        "audio_cost": 0,
        "native_web_search_cost": 0,
        "plugin_web_search_cost": 0,
        "tools_cost": 0,
        "prompt_cache_read_cost": 0,
        "prompt_cache_write_cost": 0,
        "prompt_cache_write_5_min": 0,
        "prompt_cache_write_1_h": 0,
        "reasoning_cost": 0,
        "discount_rate": 1,
        "is_byok": false,
        "byok_cost": 0
      }
    },
    "created_at": "2026-06-23 11:16:52"
  }
}

3. Detailed Pricing