Developer Documentation

Integrate once, access 19+ AI models. OpenAI-compatible API with built-in budget control.

🚀 Quick Start

1️⃣

Sign Up

Create your account at app.crawfish.top and get your API key.

2️⃣

Get Your API Key

Navigate to API Keys section, create a new key, and set your budget limits.

3️⃣

Change Base URL

Point your OpenAI SDK to https://crawfish.top/v1

🔐 Authentication

All API requests require authentication using Bearer tokens in the Authorization header:

# Header format
Authorization: Bearer sk-xxxxxxxxxxxxxxxx

🌐 Base URL

Use this base URL for all API endpoints:

https://crawfish.top/v1

💻 Code Examples

Python (OpenAI SDK)

python 
# Install: pip install openai
from openai import OpenAI

client = OpenAI(
    api_key="sk-your-key-here",
    base_url="https://crawfish.top/v1"
)

response = client.chat.completions.create(
    model="deepseek-v4",
    messages=[
        {"role": "user", "content": "Hello!"}
    ]
)
print(response.choices[0].message.content)

Node.js

javascript 
// Install: npm install openai
import OpenAI from 'openai';

const client = new OpenAI({
    apiKey: "sk-your-key-here",
    baseURL: "https://crawfish.top/v1"
});

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

cURL

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

🤖 Available Models

Use any of these model IDs in the model parameter:

🔵 DeepSeek
  • deepseek-v4 - Latest reasoning model
  • deepseek-reasoner - Deep reasoning
🟢 Zhipu GLM
  • glm-4-flash - Fast response
  • glm-4-air - Balanced
🟠 Alibaba Qwen
  • qwen-plus - Plus tier
  • qwen-turbo - Fast & cheap
  • qwen-long - Long context
🔴 ByteDance Doubao
  • doubao-pro-32k - Pro 32K
  • doubao-lite-32k - Lite 32K
🌙 Moonshot (Kimi)
  • moonshot-v1-8k - 8K context
  • moonshot-v1-32k - 32K context
🟣 Baidu ERNIE
  • ernie-4.0-8k - Latest flagship
  • ernie-3.5-8k - Stable
  • ernie-speed-8k - Fast
💎 SiliconFlow
  • sf-qwen2.5-72b - Qwen 72B
  • sf-deepseek-v3 - DeepSeek V3
  • sf-glm-4-9b - GLM 9B
  • sf-llama4-scout - Llama 4 Scout
⚡ Smart Routing
  • auto - Auto-select best model

⚠️ Error Codes

Code Meaning Solution
401 Authentication failed Check your API key is correct
429 Rate limit exceeded Wait and retry, or contact support
500 Internal server error Check status page
503 Service unavailable Model may be temporarily down
400 Invalid request Check request format and parameters

⏱️ Rate Limits

Crawfish API currently has no special rate limits. Rate limits are inherited from upstream providers.

Note: Limits may vary by model and your account tier. Check your dashboard for specific limits.

💰 Credits & Billing

  • • $1 USD = 1,000 credits
  • • Credits are deducted based on token consumption
  • • Different models have different credit costs
  • • Set budget limits per API key to control spending
View Full Pricing

💬 Support

Need help? Contact us at support@crawfish.top

We typically respond within 24 hours on business days.