API Documentation

curl https://apitopmix.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4.1",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

Authorization: Bearer sk-your-api-key-here

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1711234567,
  "model": "gpt-4.1",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Hello! How can I help you today?"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 9,
    "total_tokens": 21
  }
}

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-api-key",
    base_url="https://apitopmix.com/v1"
)

stream = client.chat.completions.create(
    model="gpt-4.1",
    messages=[{"role": "user", "content": "Write a poem about AI."}],
    stream=True
)

for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

data: {"id":"chatcmpl-abc","choices":[{"delta":{"content":"Hello"}}]}

data: [DONE]

{
  "id": "msg_01abc123",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "Hello! How can I help you today?"
    }
  ],
  "model": "claude-sonnet-4-6",
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 12,
    "output_tokens": 9
  }
}

import anthropic

client = anthropic.Anthropic(
    api_key="sk-your-api-key",
    base_url="https://apitopmix.com"
)

with client.messages.stream(
    model="claude-sonnet-4-6",
    max_tokens=500,
    messages=[{"role": "user", "content": "Write a poem about AI."}]
) as stream:
    for text in stream.text_stream:
        print(text, end="")

curl https://apitopmix.com/v1/models \
  -H "Authorization: Bearer $API_KEY"

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-api-key",
    base_url="https://apitopmix.com/v1"
)

response = client.embeddings.create(
    model="text-embedding-3-small",
    input="The quick brown fox jumps over the lazy dog."
)

embedding = response.data[0].embedding
print(f"Dimensions: {len(embedding)}")  # 1536

{
  "object": "list",
  "data": [
    {
      "object": "embedding",
      "index": 0,
      "embedding": [0.0023, -0.0091, 0.0152, ...]
    }
  ],
  "model": "text-embedding-3-small",
  "usage": { "prompt_tokens": 9, "total_tokens": 9 }
}

curl -X POST https://apitopmix.com/suno/submit/music \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A dreamy lo-fi beat with soft piano and rain sounds",
    "style": "lo-fi",
    "title": "Rainy Afternoon",
    "make_instrumental": true
  }'

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "suno_abc123def456"
  }
}

curl https://apitopmix.com/suno/fetch/suno_abc123def456 \
  -H "Authorization: Bearer $API_KEY"

{
  "code": 200,
  "data": {
    "task_id": "suno_abc123def456",
    "status": "completed",
    "tracks": [
      {
        "title": "Rainy Afternoon",
        "audio_url": "https://cdn.apitopmix.com/audio/...",
        "duration": 120,
        "style": "lo-fi"
      }
    ]
  }
}

curl -X POST https://apitopmix.com/v1/images/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-2",
    "prompt": "A majestic snow leopard on a mountain peak at sunrise, digital painting",
    "n": 1,
    "size": "1024x1024"
  }'

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-api-key",
    base_url="https://apitopmix.com/v1"
)

response = client.images.generate(
    model="nano-banana-2",
    prompt="A futuristic city with flying cars at sunset, cyberpunk style",
    n=1,
    size="1024x1024"
)

image_url = response.data[0].url
print(f"Image: {image_url}")

curl -X POST https://apitopmix.com/v1/videos \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-video-3",
    "prompt": "A golden retriever running on a beach at sunset, cinematic",
    "duration": 10,
    "resolution": "720p"
  }'

curl https://apitopmix.com/v1/videos/task_abc123xyz \
  -H "Authorization: Bearer $API_KEY"

import requests, time

BASE = "https://apitopmix.com/v1"
KEY = "sk-your-api-key"
H = {"Authorization": f"Bearer {KEY}", "Content-Type": "application/json"}

# Submit
r = requests.post(f"{BASE}/videos", headers=H, json={
    "model": "grok-video-3",
    "prompt": "A cat watching fish in an aquarium",
    "duration": 10, "resolution": "720p"
})
task_id = r.json()["id"]
print(f"Submitted: {task_id}")

# Poll
while True:
    s = requests.get(f"{BASE}/videos/{task_id}", headers=H).json()
    d = s.get("data", s)
    print(f"Status: {d.get('status')} | {d.get('progress')}")
    if d.get("status") == "SUCCESS":
        print(f"Video: {d['data']['output']}")
        break
    elif d.get("status") == "FAILURE":
        print(f"Failed: {d.get('fail_reason')}")
        break
    time.sleep(10)

{
  "error": {
    "message": "Invalid API key provided.",
    "type": "authentication_error",
    "code": "invalid_api_key"
  }
}