API Documentation

Quick Start

Just change two lines in your existing OpenAI code:

# Before (OpenAI)
from openai import OpenAI
client = OpenAI(api_key="sk-your-openai-key")

# After (API Hub) - same SDK, listed prices
from openai import OpenAI
client = OpenAI(
    api_key="sk-your-apihub-key",
    base_url="https://apihub4u.com/v1",
)

Create a new account. Returns a JWT. When email verification is required, no API key is issued until you verify; trial credits are granted on verify, then create a key in the dashboard.

Request Body

Example

# Register
curl -X POST https://apihub4u.com/auth/register \
  -H "Content-Type: application/json" \
  -d '{"email":"dev@example.com","password":"mypassword8"}'

# Response (email verification required)
{
  "token": "eyJhbGciOiJIUzI1NiIs...",
  "balance": 0,
  "email_verified": false,
  "message": "Verify your email to claim trial credits, then create an API key."
}

List all your API keys. Full keys are masked for security.

curl https://apihub4u.com/api-keys \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

Create a new API key. Optionally give it a name for identification.

curl -X POST "https://apihub4u.com/api-keys?name=production" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

Send a chat completion request. Authenticate with your API key.

Parameters

Python

from openai import OpenAI

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

response = client.chat.completions.create(
    model="deepseek-chat",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Hello!"}
    ]
)

print(response.choices[0].message.content)

Node.js

import OpenAI from "openai";

const client = new OpenAI({
    apiKey: "sk-your-apihub-key",
    baseURL: "https://apihub4u.com/v1",
});

const response = await client.chat.completions.create({
    model: "deepseek-chat",
    messages: [{role: "user", content: "Hello!"}],
});

console.log(response.choices[0].message.content);

cURL

curl https://apihub4u.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-apihub-key" \
  -d '{
    "model": "deepseek-chat",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

Streaming

# Python streaming example
stream = client.chat.completions.create(
    model="deepseek-chat",
    messages=[{"role": "user", "content": "Tell me a story"}],
    stream=True,
)
for chunk in stream:
    print(chunk.choices[0].delta.content or "", end="")

Text-to-image. Sync models (e.g. wan2.6-t2i) return OpenAI-style data[].url. Async models (e.g. wanx-v1) return a task id.

curl https://apihub4u.com/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-apihub-key" \
  -d '{
    "model": "wan2.6-t2i",
    "prompt": "A product photo of wireless earbuds on marble, soft studio light",
    "size": "1280*1280",
    "n": 1
  }'

Text-to-video / image-to-video / video edit. Always async — returns task id. For i2v pass image_url; for edit pass video_url.

curl https://apihub4u.com/v1/videos/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-apihub-key" \
  -d '{
    "model": "wan2.6-t2v",
    "prompt": "Ocean waves at sunset, cinematic camera drift",
    "duration": 5,
    "resolution": "720P"
  }'

TTS. Returns MP3/WAV bytes (OpenAI-compatible). Pass return_url=true to get a JSON URL instead.

curl https://apihub4u.com/v1/audio/speech \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-apihub-key" \
  -d '{
    "model": "cosyvoice-v3-flash",
    "input": "你好，欢迎使用 API Hub。",
    "voice": "longanyang",
    "response_format": "mp3"
  }' --output speech.mp3

Returns a list of all available models. No authentication required.

curl https://apihub4u.com/v1/models

Get your current token balance. Returns balance and email.

curl https://apihub4u.com/billing/balance \
  -H "Authorization: Bearer sk-your-apihub-key"

# Response
{"balance": 985000, "email": "dev@example.com"}

View recent usage records. Returns model, tokens consumed, cost, and timestamp for each call.

curl "https://apihub4u.com/billing/usage?limit=10" \
  -H "Authorization: Bearer sk-your-apihub-key"