Quick Start

This guide gets you from registration to your first API request in a few minutes.

1. Service URLs

Main console: https://api.geoq.help
Backup domain: https://gateway.geoq.help
OpenAI-compatible base_url: https://api.geoq.help/v1
Anthropic-compatible base_url: https://api.geoq.help
Gemini-compatible base_url: https://api.geoq.help

For self-hosted deployments, replace the domain with your own ZC_API_PUBLIC_URL.

2. Register

Open https://api.geoq.help, then register an account. Supported login methods depend on administrator settings and may include username/password, email code, OAuth, OIDC, and Passkey.

3. Create an API Token

Open the Token page in the console and create a token. Set a recognizable name, optional quota, expiration time, model scope, and IP restriction.

After submitting, copy the sk-... token immediately. It is the API key used by all later requests.

4. First Request

bash

curl https://api.geoq.help/v1/chat/completions \
  -H "Authorization: Bearer sk-your-token" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

python

from openai import OpenAI

client = OpenAI(
    base_url="https://api.geoq.help/v1",
    api_key="sk-your-token",
)

resp = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "Hello"}],
)
print(resp.choices[0].message.content)

5. Switch Models

Use the same token and endpoint, then change the model name:

Claude: claude-sonnet-4-5
Gemini: gemini-2.0-flash
DeepSeek: deepseek-chat
Qwen: qwen-max

The full model list is available in the console or through GET /v1/models.

Quick Start ​

1. Service URLs ​

2. Register ​

3. Create an API Token ​

4. First Request ​

5. Switch Models ​