From zero to production — one-stop developer guide
Create an account to get free trial credits. No credit card required.
Open the console → Tokens → Create token to get an sk- key. Tokens support quota caps, expiry dates, model restrictions, and can be disabled or deleted anytime.
Set base_url to the endpoint below and swap in your API key to call every model. Zero code changes to existing apps.
Endpoint (base_url): https://api.aigs.cc/v1
💡 The free model ox-alpha costs nothing and is unlimited — start with it to validate your integration.
AIGS is fully OpenAI-compatible. Official SDKs work out of the box: install the openai library, set api_key to your AIGS key and point base_url to https://api.aigs.cc/v1. Streaming, Function Calling, Embeddings and Vision are supported exactly like the official API.
bashcurl https://api.aigs.cc/v1/chat/completions \ -H "Content-Type: application/json" \ -H "Authorization: Bearer sk-xxxxxxxx" \ -d '{"model":"deepseek-v4-flash","messages":[{"role":"user","content":"hi"}],"stream":true}'
pythonfrom openai import OpenAI client = OpenAI(api_key="sk-xxxxxxxx", base_url="https://api.aigs.cc/v1") resp = client.chat.completions.create( model="deepseek-v4-flash", messages=[{"role": "user", "content": "hello"}], stream=True, ) for chunk in resp: print(chunk.choices[0].delta.content or "", end
typescriptimport OpenAI from "openai"; const client = new OpenAI({ apiKey: "sk-xxxxxxxx", baseURL: "https://api.aigs.cc/v1", }); const stream = await client.chat.completions.create({ model: "deepseek-v4-flash", messages: [{ role: "user", content: "hello" }], stream: true, }); chunk stream processstdoutchunkchoicesdeltacontent
Tip: Every parameter (model, messages, tools, max_tokens, temperature, …) stays identical to the official API — no adapter layer needed.
Fill in these two fields in your app's "OpenAI-compatible" settings (apps without native OpenAI support can also connect via reverse proxy):
https://api.aigs.cc/v1 (some apps use https://api.aigs.cc)sk- key from the consoleVerified apps: Dify, FastGPT, LobeChat, Cherry Studio, ChatBox, Cursor, Cline, Immersive Translate and more.
Pay per token with micro-yuan precision (¥0.000001). Every call is itemized in the console in real time.
Credits stay valid forever — top up anytime, no minimums, pay only for what you use.
Listed prices are official vendor price × 1.15, always comparable. Live prices are shown in the console Model Hub.
ox-alpha costs nothing and is unlimited — perfect for debugging and low-cost workloads.
Member groups enjoy discounted model rates. Top-ups and balance live under "Top-up" in the console.
| Code | Meaning | What to do |
|---|---|---|
401 UNAUTHORIZED | Invalid or expired token | Verify the key exists and is not deleted, disabled or expired |
402 INSUFFICIENT_QUOTA | Insufficient balance | Top up in console or raise the token quota cap |
400 INVALID_INPUT | Malformed request | Check the model name and messages format |
404 MODEL_NOT_FOUND | Model not found or unlisted | Confirm the model name and availability in the Model Hub list |
429 RATE_LIMITED | Rate limit hit | Slow down requests, or upgrade your group / membership |
503 MODEL_UNAVAILABLE | Upstream temporarily down | Retry shortly; backup channels switch automatically |