Overview

How AirCube works

AirCube provides a unified REST API for running 55+ AI models (image, video, audio). All requests follow an asynchronous two-step pattern:

1. Submit — POST a generation request. You receive a generation ID immediately.
2. Poll — GET the status until it's completed and your output URL is ready.

This async pattern is necessary because generation can take from a few seconds (images) to several minutes (long videos).

Get started

1. Sign up and create an API key

Sign up for an AirCube account — new accounts include free credits, no credit card required.

Go to API Keys in your dashboard, click "+ Create API key". Copy the key immediately (it's shown only once):

export AIRCUBE_API_KEY="sk-your-api-key-here"

2. Discover models

Call the models endpoint to see what's available:

curl https://aircube.ai/api/v3/models \
  -H "Authorization: Bearer $AIRCUBE_API_KEY"

Each model entry returns a slug and tasks array. Combine them: POST /api/v3/{slug}/{task}.

3. Generate and poll

Pick a model, submit a generation, and poll for the result:

# Submit — returns a generation ID immediately
curl -X POST https://aircube.ai/api/v3/seedream-v5.0-pro/text-to-image \
  -H "Authorization: Bearer $AIRCUBE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "an isometric illustration of a data center"}'

# Poll — repeat until status is "completed"
curl https://aircube.ai/api/v3/status/YOUR_GENERATION_ID \
  -H "Authorization: Bearer $AIRCUBE_API_KEY"

When status is completed, the output_url field contains a signed download link (valid 7 days).

Next steps

• Quickstart — complete end-to-end examples (image, video, audio) with cURL, Python, and JavaScript.
• Models — browse all models with slugs, tasks, and pricing.
• Submit Generation — full parameter reference by task type.
• Error Codes — error handling and retry strategies.