> ## Documentation Index
> Fetch the complete documentation index at: https://aisa.one/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> - Base URLs: models `https://api.aisa.one/v1` (Gemini GenerateContent: `https://api.aisa.one/v1beta`); data APIs `https://api.aisa.one/apis/v1`. The `servers` of each operation in https://aisa.one/openapi.yaml is authoritative.
> - Auth: `Authorization: Bearer $AISA_API_KEY`. Never print, log, or commit the key.
> - MCP (preferred for agents): `https://mcp.aisa.one/mcp`, signed in with OAuth, so there is no key to paste.
> - Agent Skill: `npx skills add AIsa-team/agent-skills --skill aisa`. Fallback with the AIsa CLI: `aisa skills install aisa`.
> - Spending: docs, https://aisa.one/models, https://aisa.one/api, `/v1/models`, and MCP `search`, `list_categories`, `get_details`, `batch_quote`, and the `account` operation are free. Quote the exact calls before running them (MCP `batch_quote`, CLI `aisa quote --json`). If the quote reports `auto_execute_eligible: true`, run it unless the user set a tighter limit or asked only for a quote. Otherwise, tell the user in one message the planned calls, the quoted price, and a total USD budget for the task, then wait for approval. Direct HTTP calls follow the stricter rule at https://aisa.one/docs/get-started/cli.md#direct-http-fallback. Do not make paid calls to test availability. Full rule: https://aisa.one/llms.txt

# HappyHorse API - Access HappyHorse Video Models via AIsa

> AIsa guide to HappyHorse video generation model IDs and endpoints: text-to-video, image-to-video, and reference-to-video.

AIsa gives you access to HappyHorse video generation models with one AIsa API key. The model ID suffix names the input: `t2v` is text-to-video, `i2v` is image-to-video, and `r2v` is reference-to-video.

Video generation is asynchronous. Submit the job to `POST /v1/video/generations`, then poll `GET /v1/video/generations/{task_id}` until it finishes. See [Retrieve a video generation task](https://aisa.one/docs/api-reference/media-generation/retrieveVideoGeneration.md).

## Supported HappyHorse models

| Model ID | Type | Endpoints | Best for |
| - | - | - | - |
| `happyhorse-1.1-i2v` | Video | `/v1/video/generations` | Image-to-video generation |
| `happyhorse-1.1-r2v` | Video | `/v1/video/generations` | Reference-to-video generation |
| `happyhorse-1.1-t2v` | Video | `/v1/video/generations` | Text-to-video generation |

Current prices for these models are on [aisa.one/models](https://aisa.one/models).

## Next

* [Model Catalog](https://aisa.one/docs/guides/models.md)
* [AI model pricing](https://aisa.one/docs/guides/pricing.md#models)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.