Skip to main content
AIReiter is a unified AI content generation API platform that provides image and video generation services. With simple REST API calls, you can use multiple mainstream AI models such as GPT-4o, Gemini, Sora2, and VEO3 to generate high-quality image and video content.

​
Quick Start

Image Generation

Generate images using models like GPT-4o, Gemini, Seedream

Video Generation

Generate video content using models like Sora2, VEO3

Task Status Query

Retrieve the execution status and results of asynchronous tasks

Get API Key

Access the console to get your API Key

​
API Workflow

​
1. Submit Generate Task

All image and video generation processes are handled asynchronously. When submitting a task, you need to provide out_task_id (initiator’s task ID). The system will return both task_id and out_task_id: 
curl --request POST \
  --url https://test.aireiter.com/api/openapi/submit \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt_4o",
    "params": {
      "prompt": "a cute cat in the garden",
      "aspect_ratio": "1:1"
    },
    "out_task_id": "my_task_123456"
  }'

​
2. Query Task Status

Use the returned task_id or your submitted out_task_id to query the task progress and result (either one): 
# Query using task_id
curl --request POST \
  --url https://test.aireiter.com/api/openapi/query \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "task_id": "order_xxxxxxxxxxxx"
  }'

# Or query using out_task_id
curl --request POST \
  --url https://test.aireiter.com/api/openapi/query \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "out_task_id": "my_task_123456"
  }'

​
3. Get the Generated Result

After the task is completed, the response will contain the generated image or video URL: 
{
  "statusCode": 200,
  "message": "",
  "data": {
    "task_id": "order_xxxxxxxxxxxx",
    "out_task_id": "my_task_123456",
    "status": "completed",
    "output": [
      {
        "url": "https://s1.pxz.ai/upload/image-generator/xxx.jpeg"
      }
    ]
  }
}

​
Supported Models

​
Image Generation Series

AIReiter offers a variety of image generation models, supporting both text-to-image and image-to-image capabilities:

GPT-4o Image

OpenAI’s high-quality image generation model

Gemini-2.5-Flash (Nano banana)

Google’s latest fast image generation model

Gemini-3-Pro (Nano banana pro)

Google’s professional-grade image generation model

Seedream-4.0

Efficient image generation solution

Seedream-4.5

Latest version of Seedream

​
Video Generation Series

Supports text-to-video and image-to-video, offering various resolution and duration options:

Sora2

OpenAI Sora2 video generation model (10-15 seconds)

Sora2 Pro

Sora2 Pro, supports HD resolution

VEO3.1

Google VEO3.1 video generation model

VEO3.1 Fast

VEO3.1 Fast version

​
Core Features

​
Asynchronous Task Processing

All generate requests use an asynchronous processing mode to avoid long waits:
  • When submitting a task, you need to provide out_task_id (initiator’s task ID for business identification)
  • Immediately returns the system-generated task_id along with your submitted out_task_id
  • You can query task status using either task_id or out_task_id (choose one)
  • Supports optional webhook callback notifications
  • Task status updates in real time: pending → processing → completed

​
Multi-Model Support

A unified API endpoint supporting various image and video generation models:
  • Image Generation: 5 models including GPT-4o, Gemini, Seedream
  • Video Generation: 4 models including Sora2, VEO3
  • Unified request format and response structure
  • Flexible parameter configuration

​
Transparent Pricing

Charged by points, clear and transparent:
  • Each task returns an estimated point consumption
  • Actual point consumption is shown after task completion
  • Pay only for successfully generated content
  • No hidden fees

​
Flexible Configuration

Supports various generation parameter settings:
  • Images: multiple aspect ratios (1:1, 3:2, 2:3)
  • Videos: multiple aspect ratios (16:9, 9:16), durations (10 seconds, 15 seconds), resolutions
  • Supports reference images (image-to-image, image-to-video)
  • Custom metadata

​
Authentication Method

All API requests require authentication using a Bearer Token: 
Authorization: Bearer YOUR_API_KEY
Get API Key: Visit the API Key Management Page to obtain your API key.

​
FAQ

Visit the API Key Management page, where you can create and manage your API Key after logging in.
All generation tasks are processed asynchronously. Image generation usually takes a few seconds to tens of seconds, while video generation typically takes 1-5 minutes depending on duration and resolution. After submitting a task, a task_id is returned immediately. You can track progress through the status query API.
Use the task status query API by passing the task_id returned when the task was submitted, or your own out_task_id (either one):
POST https://test.aireiter.com/api/openapi/query
See the Task Status Query Documentation for details.
The out_task_id is the initiator’s task ID, custom set by you when submitting the task:
  • Required Parameter: You must provide out_task_id when submitting a task
  • Business Identifier: You can use your system’s order number, business ID, or other identifiers
  • Flexible Querying: You can query the task status directly using out_task_id without saving the system returned task_id
  • Result Association: The query results will include both task_id and out_task_id for convenient business data association
Yes. You can provide a callback_url parameter when submitting a task. After the task completes, the system will send a POST request to this address containing the full task result.
AIReiter uses a credit-based billing system:
  • An estimated credit consumption (estimated_credits) is returned when submitting the task
  • The actual consumed credits (credits_used) are returned after task completion
  • Only successful generation content is charged; failed tasks are free
  • Credit consumption varies by model
  • Images: Supports common formats such as JPEG, PNG
  • Videos: Outputs in MP4 format
  • Reference Images: Input supports publicly accessible image URLs

​
Next Steps

View Image Generation Documentation

Learn how to use various image generation models

View Video Generation Documentation

Learn how to generate video content

Task Management

Learn how to manage and query task statuses

Get API Key

Start using AIReiter now