Quick Start

Quickly start using our API services.

Welcome to 123API. This guide helps you quickly get started with text, image, video and audio capabilities through one OpenAI-compatible endpoint.

Step 1: Get an API Key

1. Visit the 123API Dashboard 
2. Sign in to your account
3. Create a new API key
4. Save your key securely and store it in your own environment variables

Step 2: Choose a Model

We provide multiple AI model families to choose from.

Text Generation Models

• GPT-5 / GPT-4o: dialogue, reasoning and code generation
• Claude: strong reasoning and long-context conversations
• Gemini: multimodal and fast-response model family

Image Generation Models

• GPT-4o-image: high-quality image generation and editing

Video Generation Models

• Sora-style models: async video generation
• VEO-style models: async video generation with task status retrieval

Step 3: Send a Request

Text generation example

curl -X POST https://123api.co/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://123api.co/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://123api.co/v1/videos/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "veo3.1-fast",
    "prompt": "Waves crashing against the shore",
    "duration": 8,
    "aspect_ratio": "16:9"
  }'

Step 4: Check Task Status

Image and video APIs typically use asynchronous processing. Query task status to obtain the final result.

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

What’s Next