球球TokenQiuqiu Token Docs
中文

Quick Start

Follow this order: log in, check balance, choose a model, create a token, then configure and use the model in your client.

Flow Overview

  1. Log in: open the Qiuqiu Token console and confirm that your account is accessible.
  2. Check balance: open wallet management and confirm that the account has usable balance.
  3. Choose a model: decide which model, client, and budget you want to use.
  4. Create a token: create an API Key for the target model and group.
  5. Configure and use the model: paste the Base URL, API Key, and model into the client.
Five-step quick start flow

Step 1: Log In

Open the login page and sign in to the Qiuqiu Token console.

If you do not have an account yet, open the registration page first.

Step 2: Check Remaining Balance

After logging in, open Wallet Management and confirm that the remaining balance is enough for your next model calls.

Qiuqiu Token supports in-site recharge:

  1. Open Wallet Management.
  2. Check the current remaining balance.
  3. If the balance is insufficient, choose a payment method and complete payment.
  4. Return to Wallet Management and confirm that the balance has updated.

Verification:

  • The console opens normally.
  • Wallet Management shows the current balance.
  • After recharge, the balance is not zero or the updated amount is visible.

Step 3: Choose the Model

Before creating a token, decide the final model you want to use. Different models, clients, and groups may have different prices, multipliers, speed, and stability policies.

Answer these questions first:

  • Which tool will use this token: Codex, Claude Code, Claude Desktop, Gemini CLI, Trae, or your own application?
  • Is the target tool already installed?
  • What is the main task: coding, long-form writing, image generation, data analysis, automation, or daily chat?
  • What matters most: speed, stability, model authenticity, cost, or context length?
  • What is the budget: small test or long-term high-frequency usage?
  • Is the target model available in the selected group, and are the price and multiplier acceptable?

Verification:

  • You know the model name to enter in the client.
  • You know which token group to choose.
  • The balance is enough for at least one test request.

Step 4: Create a Token

Open Token Management, click "Add Token", and create an API Key for the model and group you chose.

Check these fields:

  • Name: use a clear purpose such as codex-plus-demo or claude-code-work.
  • Token group: choose by client, model, or pool. Do not choose default by habit.
  • Expiration: beginners can choose "never expire" to avoid debugging interruptions.
  • Quota: start with a small test quota, then adjust after verification.

Do not choose default

default is not a dedicated pool for Codex, Claude Code, and similar clients. Choosing the wrong group can cause model mismatch, client failure, or unexpected billing.

After submission, return to Token Management and copy the token from the row copy icon or "copy selected token". That value is the API Key for the client.

For screenshots, see Create an API Token.

Step 5: Configure and Use the Model

Most clients need three values: Base URL, API Key, and model name.

OpenAI-compatible clients need /v1. Claude-compatible clients should not manually append /v1 to the Base URL.

https://api.qiuqiutoken.com/v1
https://api.qiuqiutoken.com

Common choices:

  • Codex, Gemini CLI, Trae, and your own OpenAI-compatible interface: https://api.qiuqiutoken.com/v1.
  • Claude Code and Claude Desktop: https://api.qiuqiutoken.com.

Backup API domains:

https://api.qiuqiutoken.com
https://api2.qiuqiutoken.com
https://api.qiuqiutoken.jiawuyu.com
https://api2.qiuqiutoken.jiawuyu.com

Use the token copied in step 4 as the API Key. Use the model name decided in step 3. Available models, prices, and multipliers are subject to the official marketplace and console.

Next entry points:

curl Verification

For OpenAI-compatible APIs, replace PASTE_YOUR_API_KEY with the token you copied.

OpenAI-compatible check
curl https://api.qiuqiutoken.com/v1/models \
  -H "Authorization: Bearer PASTE_YOUR_API_KEY"

For Claude-compatible APIs, do not add /v1 to the Base URL yourself; the request path provides it.

Claude-compatible check
curl https://api.qiuqiutoken.com/v1/messages \
  -H "x-api-key: PASTE_YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d "{\"model\":\"claude-sonnet-4-20250514\",\"max_tokens\":32,\"messages\":[{\"role\":\"user\",\"content\":\"hello\"}]}"

Next