​

Quick Start

​

Step 1: Get an API Key

1. Visit the API Key Management page
2. Sign in to your account

   Visit the OneAster console and sign in to your account, then open the API key management page.

3. Create a new API key On the API Keys page, click the Create API Key button in the top-right corner.

   On the API key management page, click Create API Key at the top right to open the new key form.

   In the dialog that appears, enter a Name for the key, optionally configure the quota (Unlimited Quota), model limits (Enable Model Limits) and an IP whitelist, then click Create Key.

   In the new key form, enter Name, configure Unlimited Quota, Enable Model Limits, and the IP allowlist as needed, then click Create Key.

4. Save your key securely

   Find the new key in the key list and click its copy button. Store it securely for client configuration; keep the complete key out of public documents and repositories.

​

Step 2: Choose a Model

​

Text Generation Models

• GPT-4o: Powerful dialogue and text generation capabilities
• Claude: High-performance conversational model by Anthropic
• Gemini: Google’s multimodal large language model

​

Image Generation Models

• GPT-4o-image: High‑quality image generation

​

Video Generation Models

• Sora2: Professional video generation

​

Step 3: Send a Request

​

Text generation example

curl -X POST https://api.oneaster.ai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {
        "role": "user",
        "content": "Hello, please introduce yourself"
      }
    ]
  }'

​

Image generation example

curl -X POST https://api.oneaster.ai/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-image",
    "prompt": "A cute panda",
    "size": "1:1",
    "n": 1
  }'

​

Video generation example

curl -X POST https://api.oneaster.ai/v1/videos/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2",
    "prompt": "Waves crashing against the shore",
    "duration": 15,
    "aspect_ratio": "16:9"
  }'

​

Step 4: Check Task Status

curl -X GET https://api.oneaster.ai/v1/tasks/YOUR_TASK_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

​

What’s Next