API One Documentation
API One is a unified AI content generation API platform supporting language models, image, and video generation.
Introduction
API One provides a unified interface to access various AI generation models, including language models (LLM), image generation, and video generation. The platform is compatible with OpenAI API format.
- Base URL:
https://apione.org - Authentication: Carry your API Key in the request header
Authorization: Bearer sk-xxxxxxxxxxxxAPI Keys can be obtained from the console under "API Tokens".
Async Task Workflow
Image / video / music generation tasks are async tasks: after submission, a task ID is returned immediately. Poll the query interface until the task completes and the result URL is available.
1. Submit task → POST /v1/images/generations or /v1/videos/generations
2. Receive task_id
3. Poll result → GET /v1/api/result?id={task_id}
4. status=succeeded → Fetch result from results[].url (valid for 24 hours)API Overview
| API | Purpose | Use Case |
|---|---|---|
| Async Result Query | Query single task status and result by task ID | Poll after task submission (recommended) |
| Task List Query | Paginated query of your task history | View history, bulk management |
| Token Balance Query | Query token quota and usage | Balance check, usage monitoring |
| Model Fluency Query | Query current congestion status of each model | Choose the best model channel |
| Language Models | Call the LLM chat completion endpoint | Text conversation, content generation, function calling |
| Image Generation | Submit image generation tasks | Text-to-image, image-to-image |
| Veo Video Generation | Submit video tasks | Text-to-video, image-to-video |
| Veo 3.1 Google Native | Submit video tasks (Google direct) | Audio video, multi-image reference |
| Seedance 2.0 Video | Submit Seedance video tasks | Character video, keyframe transition |
| File Upload | A storage pool is not provided for now — please configure your own, e.g. Cloudflare R2 | Hosting reference images, videos, etc. |
Common Error Codes
| HTTP | type | Description |
|---|---|---|
| 400 | invalid_request_error | Invalid request parameters |
| 401 | authentication_error | Authentication failed, check API Key |
| 402 | payment_required | Insufficient balance |
| 403 | permission_error | No permission to access the resource |
| 429 | rate_limit_error | Too many requests, please retry later |
| 500 | server_error | Internal server error |
| 502 | bad_gateway | Gateway error, upstream unavailable |