Quick Start ​

Welcome to 开桥! This guide walks you through everything from signing up to making your first API request, step by step.

1. Sign in to 开桥: Visit the 开桥 login page and sign in using any of the following:

   • Email
   • GitHub account
   • Google account

2. Choose a usage plan: Based on your use case, select Pay As You Go or 订阅计划.

3. Get an API key: After signing in, create an API key from the corresponding management page.

4. Make your first request: Pick the API protocol you're most familiar with, copy the code example below, replace your API key, and run it.

Choose a Usage Plan ​

开桥 offers two usage plans to fit different scenarios:

Pay As You Go ​

Best for: Production environments, commercial products, high-concurrency applications

Pay As You Go uses a prepaid balance + usage-based billing model, purpose-built for production workloads:

• No rate limits — supports high-concurrency calls
• Per-token billing — transparent and predictable costs

Go to the Pay As You Go management page to top up your balance and create an API key.

订阅计划 (Subscription) ​

Best for: Personal development, learning and exploration, Vibe Coding, rapid prototyping

订阅计划 provides a fixed monthly fee with predictable AI model access:

• Fixed monthly fee starting at $20/month
• All-star model lineup — one subscription unlocks 100+ top models worldwide
• Full-scenario coverage — Coding + image generation + video generation + chat, all in one place

Go to the Pricing page to view plan details and subscribe.

Plan Comparison ​

Supported API Protocols ​

开桥 supports four major API protocols, letting you use your preferred SDK to call any model on the platform:

Protocol 1: OpenAI Chat Completions ​

from openai import OpenAI

# 1. Initialize the OpenAI client
client = OpenAI(
    # 2. Point the base URL to the 开桥 endpoint
    base_url="https://openqiao.com/api/v1", 
    # 3. Replace with the API key from your 开桥 console
    api_key="<your OPENQIAO_API_KEY>", 
)

# 4. Create a Chat Completion request
completion = client.chat.completions.create(
    # 5. Specify the model in "provider/model-name" format
    model="google/gemini-3.1-pro-preview", 
    messages=[
        {
            "role": "user",
            "content": "What is the meaning of life?"
        }
    ]
)

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

import OpenAI from "openai";

// 1. Initialize the OpenAI client
const openai = new OpenAI({
  // 2. Point the base URL to the 开桥 endpoint
  baseURL: "https://openqiao.com/api/v1", 
  // 3. Replace with the API key from your 开桥 console
  apiKey: "<your OPENQIAO_API_KEY>", 
});

async function main() {
  // 4. Create a Chat Completion request
  const completion = await openai.chat.completions.create({
    // 5. Specify the model in "provider/model-name" format
    model: "google/gemini-3.1-pro-preview", 
    messages: [
      {
        role: "user",
        content: "What is the meaning of life?",
      },
    ],
  });

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

main();

curl https://openqiao.com/api/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $OPENQIAO_API_KEY" \
  -d '{
    "model": "google/gemini-3.1-pro-preview",
    "messages": [
      {
        "role": "user",
        "content": "What is the meaning of life?"
      }
    ]
  }'

Protocol 2: OpenAI Responses ​

from openai import OpenAI

client = OpenAI(
    base_url="https://openqiao.com/api/v1", 
    api_key="<your OPENQIAO_API_KEY>", 
)

# Create a request using the Responses API
response = client.responses.create(
    model="google/gemini-3.1-pro-preview", 
    input="What is the meaning of life?"
)

print(response.output_text)

import OpenAI from "openai";

const openai = new OpenAI({
  baseURL: "https://openqiao.com/api/v1", 
  apiKey: "<your OPENQIAO_API_KEY>", 
});

async function main() {
  const response = await openai.responses.create({
    model: "google/gemini-3.1-pro-preview", 
    input: "What is the meaning of life?", 
  });

  console.log(response.output_text);
}

main();

curl https://openqiao.com/api/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $OPENQIAO_API_KEY" \
  -d '{
    "model": "google/gemini-3.1-pro-preview",
    "input": "What is the meaning of life?"
  }'

Protocol 3: Anthropic Messages ​

from anthropic import Anthropic

# 1. Initialize the Anthropic client
client = Anthropic(
    # 2. Point the base URL to the 开桥 endpoint
    base_url="https://openqiao.com/api/anthropic", 
    # 3. Replace with the API key from your 开桥 console
    api_key="<your OPENQIAO_API_KEY>", 
)

# 4. Create a Messages request
message = client.messages.create(
    model="google/gemini-3.1-pro-preview", 
    max_tokens=1024,
    messages=[
        {
            "role": "user",
            "content": "What is the meaning of life?"
        }
    ]
)

print(message.content[0].text)

import Anthropic from "@anthropic-ai/sdk";

// 1. Initialize the Anthropic client
const client = new Anthropic({
  // 2. Point the base URL to the 开桥 endpoint
  baseURL: "https://openqiao.com/api/anthropic", 
  // 3. Replace with the API key from your 开桥 console
  apiKey: "<your OPENQIAO_API_KEY>", 
});

async function main() {
  // 4. Create a Messages request
  const message = await client.messages.create({
    model: "google/gemini-3.1-pro-preview", 
    max_tokens: 1024,
    messages: [
      {
        role: "user",
        content: "What is the meaning of life?",
      },
    ],
  });

  console.log(message.content[0].text);
}

main();

curl https://openqiao.com/api/anthropic/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: $OPENQIAO_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "google/gemini-3.1-pro-preview",
    "max_tokens": 1024,
    "messages": [
      {
        "role": "user",
        "content": "What is the meaning of life?"
      }
    ]
  }'

Protocol 4: Google Gemini ​

from google import genai
from google.genai import types

# 1. Initialize the Google GenAI client
client = genai.Client(
    # 2. Replace with the API key from your 开桥 console
    api_key="<your OPENQIAO_API_KEY>", 
    vertexai=True, 
    # 3. Point the base URL to the 开桥 endpoint
    http_options=types.HttpOptions(
        api_version='v1',
        base_url='https://openqiao.com/api/vertex-ai'
    )
)

# 4. Create a generateContent request
response = client.models.generate_content(
    model="google/gemini-3.1-pro-preview", 
    contents="What is the meaning of life?"
)

print(response.text)

import { GoogleGenAI } from "@google/genai";

// 1. Initialize the Google GenAI client
const ai = new GoogleGenAI({
  // 2. Replace with the API key from your 开桥 console
  apiKey: "<your OPENQIAO_API_KEY>", 
  vertexai: true, 
  // 3. Point the base URL to the 开桥 endpoint
  httpOptions: {
    apiVersion: "v1",
    baseUrl: "https://openqiao.com/api/vertex-ai", 
  },
});

async function main() {
  // 4. Create a generateContent request
  const response = await ai.models.generateContent({
    model: "google/gemini-3.1-pro-preview", 
    contents: "What is the meaning of life?",
  });

  console.log(response.text);
}

main();

Platform API ​

开桥 provides a set of Platform Management APIs that let you programmatically query account usage, balance, subscription status, and more — making it easy to integrate with your monitoring and management systems.

Query Generation Details ​

Retrieve detailed information about a specific API call, including token usage, latency, and billing breakdown.

GET https://openqiao.com/api/v1/management/generation?id=<generation_id>

Each API call returns a generation_id. Use that ID to query the full details of the call:

curl https://openqiao.com/api/v1/management/generation?id=gen_01abc123def456 \
  -H "Authorization: Bearer $OPENQIAO_API_KEY"

Example response (partial):

{
  "api": "chat.completions",
  "generationId": "gen_01abc123def456",
  "model": "openai/gpt-4o",
  "generationTime": 3200,
  "latency": 500,
  "nativeTokens": {
    "completion_tokens": 128,
    "prompt_tokens": 32,
    "total_tokens": 160
  },
  "usage": 0.0052
}

Query PAYG Balance ​

Retrieve the current Pay As You Go balance for your account.

GET https://openqiao.com/api/v1/management/payg/balance

curl https://openqiao.com/api/v1/management/payg/balance \
  -H "Authorization: Bearer $OPENQIAO_MANAGEMENT_API_KEY"

Example response:

{
  "success": true,
  "data": {
    "currency": "usd",
    "total_credits": 482.74,
    "top_up_credits": 35.0,
    "bonus_credits": 447.74
  }
}

Query Subscription Details ​

Retrieve your account's subscription information, including plan tier, Flow rate, and quota usage.

GET https://openqiao.com/api/v1/management/subscription/detail

curl https://openqiao.com/api/v1/management/subscription/detail \
  -H "Authorization: Bearer $OPENQIAO_MANAGEMENT_API_KEY"

Example response (partial):

{
  "success": true,
  "data": {
    "plan": {
      "tier": "ultra",
      "amount_usd": 200,
      "interval": "month"
    },
    "account_status": "healthy",
    "quota_5_hour": {
      "max_flows": 800,
      "used_flows": 57.2,
      "remaining_flows": 742.8,
      "usage_percentage": 0.0715,
      "remaining_resets": 1
    },
    "quota_7_day": {
      "max_flows": 6182,
      "used_flows": 416.11,
      "remaining_flows": 5765.89
    }
  }
}

Query Flow Rate ​

Retrieve the current Flow rate information for your account.

GET https://openqiao.com/api/v1/management/flow_rate

curl https://openqiao.com/api/v1/management/flow_rate \
  -H "Authorization: Bearer $OPENQIAO_MANAGEMENT_API_KEY"

Example response:

{
  "success": true,
  "data": {
    "currency": "usd",
    "base_usd_per_flow": 0.03283,
    "effective_usd_per_flow": 0.03283
  }
}

Advanced Usage ​

For more details on advanced usage, refer to the Advanced Usage section.