FAQ Overview - API易文档中心

Find answers to platform questions about APIYI accounts, tokens, logs, billing, and connections. Start with Getting Started and Top Questions, or use Troubleshooting by Symptom. For models, API parameters, and client tools, follow the Documentation Guides below.

🚀 Getting Started in 3 Steps

Step 1: Register

Gmail, Outlook, Foxmail and university email addresses are supported, or sign in with GitHub

Step 2: Create a KEY

Grab the default token from the console, or create a dedicated KEY and pick its group

Step 3: Make an API Call

Follow the API manual to configure your client and send a first request

🔥 Top Questions

How to create a KEY?

Getting the default token and creating a new KEY, step by step

How to keep your account secure?

Bind 2FA or a Passkey for a second verification step beyond your password

Why is my API Key invalid?

Nine times out of ten the Base URL and KEY do not match — check this first

Why can't I run requests with a balance?

The pre-deduction mechanism and oversized max_tokens values

What does the model multiplier mean?

The multiplier is an RMB unit — apply the fixed rate to get the USD equivalent

What recharge promotions are available?

First-time bonuses, tiered bonuses, and enterprise policies

🔧 Troubleshooting by Symptom

Find the row that matches what you are actually seeing. A single symptom often spans several topics, so this table re-threads the troubleshooting articles by observable behavior.

What you see	Likely cause	Read
API Key invalid / 401	Base URL and KEY do not match, or the KEY is mistyped	Invalid API Key
Balance, log or token management API returns 401 `ACCESS_TOKEN_LEGACY_RETIRED` or 403 `ACCESS_TOKEN_SCOPE_DENIED`	Legacy system token retired, or the personal access token lacks the required permission	Personal access tokens
Balance remaining but requests fail	Pre-deduction mechanism, or max_tokens set too high	Balance insufficient · Pre-deduction
Request times out or drops mid-stream	Client timeout too short; reasoning models are slow	Avoiding API timeouts
Log shows success and billing, but nothing reached the client	The log duration stops when the gateway finishes; the gap is downstream or in the finish signal	Log finished but no response
Website / API returns 502	Service container briefly auto-restarting; recovers in about 1 minute	What to do about 502
Script gets intermittent 502 with an empty body and nothing in the logs	Empty 502 generated by local proxy software (Clash / v2rayN)	Proxy-generated empty 502
Image calls behind a VPN drop in batches after 90-180 s but are still billed	The local proxy closes connections that carry no data for too long	Proxy idle disconnects
Direct connection: 4K images hang with no error, log shows `write_response_body_failed`	Your direct line cannot carry responses of tens of MB	Direct line drops large images
Python raises SSLEOFError but curl works	OpenSSL 3.5+ post-quantum handshakes cut by middleboxes	SSLEOFError troubleshooting
A specific model won’t run	Account permission locked, or token model whitelist	Why can’t I use some models · Token model whitelist
Unfamiliar calls on your KEY	The KEY may be leaked — trace it and disable it	Investigate unexpected KEY usage · Manage keys securely
Billing doesn’t add up	Per-usage and per-call billing read differently	Reading billing in logs · Model multiplier
Image or video downloads are slow or hit Read timed out	Generation succeeded; self-check and send us the results	CDN downloads slow or timing out
Do I need a proxy?	Direct connection works; no proxy required	Do I need a proxy
GitHub login says ‘Account already bound’	That GitHub account is bound to another email	GitHub binding error
Forgot your password	Reset by email or ask support for help	Forgot password

📖 Documentation Guides

Model behavior, API parameters, and client tools are covered alongside their integration guides.

API Integration

Base URL, file inputs, request errors, and concurrency

Model Selection

Model capabilities, selection, and common behavior questions

Image and Video Generation

Follow each model’s guide for generation and troubleshooting

Clients and Agents

Integration guides and troubleshooting for clients and Agent tools

📚 Browse by Topic

🧭 Site Features (4)

Question	One-line answer
Tokens & Groups	How to create a KEY and pick a group
What is a Group? User Group vs Token Group Explained	The group selected on the token is what actually applies
How Do the Codex, ClaudeCode, and Default Groups Differ?	Different origins and protocols; prefer Default official-relay in production
Why Doesn’t APIYI Offer One-Click Integration?	Integration differs per model; use the AI assistant instead

🔑 Tokens & Logs (14)

Question	One-line answer
How to create a KEY?	Get the default token or create a new one in the console
Do I Need to Set Available Models for Tokens?	Optional, but recommended when isolating projects
How Do I Manage API Keys Securely?	IP whitelists, model whitelists, and daily habits
What Is a Personal Access Token and How Do I Replace the System Token?	New credential for management APIs; system tokens retire on 11-11
What’s the Difference Between Token Billing Modes?	Five billing modes and when each fits
How to view my call records?	Call and billing detail in the console log page
Where Can I Find the Request ID?	Check response headers or body by API type; don’t mistake a task ID for it
How do I read the billing amounts in the logs?	Per-usage vs per-call, and computing cost from usage
How long are call logs kept, and when are they cleared?	Current month plus two prior; cleared on the 5th
What should I know about log timezone settings and data export?	Keep the account timezone at UTC+0; exports are always UTC+0
Can I View Detailed Logs in the Backend for Troubleshooting?	Admins can enable verbose logging temporarily
How do I investigate unexpected API Key usage?	Trace real IPs in the logs and disable the KEY
Why can’t I use some models?	Some models need permission unlocked first
The log says the call finished and was billed, but my client never received a response — how do I troubleshoot?	The two clocks measure different windows; measure the gap first

🏢 Enterprise Services (9)

Question	One-line answer
What Is the Enterprise Group? When Should You Use It?	Model-specific group with steadier supply, higher multiplier
Is There a Faster or Enterprise Route for Image Generation?	No express lane; the time goes into model inference itself
Is APIYI’s Enterprise Service Trustworthy? Are the Models Authentic?	Transparent official relay — no rerouting or model swapping
What’s the difference between enterprise and individual users?	Same account type; differences are in support and pricing
How do enterprise customers recharge?	Bank transfer preferred; framework contracts and VAT invoices available
How can university customers reimburse worry-free?	Invoices, purchase lists, and stamped documents provided
Does APIYI offer SLA guarantees?	Yes, including billing-anomaly compensation and credit refills
Does an Agent Mini-Program Need Algorithm Filing?	Usually yes; this covers the general process
How Do I Handle Compliance for a China-Facing Product Using Overseas Models?	License layers, model filing status, and content moderation

💰 Billing & Security (18)

Question	One-line answer
Prices Match the Official Rates — Why Buy from APIYI?	Same price plus recharge bonuses, stackable with group discounts
How can APIYI price below the official rates?	Bulk purchasing and vendor distribution, not degraded models
What Does the Model ‘Multiplier’ Mean?	An RMB unit; apply the fixed rate for the USD equivalent
How Much Computing Power Does 100 RMB Get?	Top-ups use a fixed 1 USD = 7 RMB rate; your system sets the ratio
Does APIYI Support Cache Billing?	All major routes support it; hit rates vary by vendor
What is the pre-deduction mechanism for API calls?	Estimated upfront, settled against actual usage
Why can’t I run requests with remaining balance?	Pre-deduction check, or max_tokens set too high
How to Set Up Balance Alerts?	Email, group bots, or the balance alert API
Does my APIYI balance expire? What is the validity period?	365 days; any new top-up resets the whole balance
What Payment Methods Does APIYI Support?	WeChat, Alipay, USDT, Stripe, PayPal and more
What if my invoice amount is less than $100?	Combine small orders until they reach $100
I entered the wrong invoice details. Can the invoice be reissued?	Submit the original plus correct details for a reversal and reissue
What recharge promotions are available?	First-time and tiered bonuses, plus invoicing
How do I apply for an agent partnership? Can I earn rebates by inviting friends?	Referral rebates are on by default; no application needed
What Is APIYI’s Refund Policy?	Conditions, process, fees, and invoice notes
How is content safety and compliance ensured?	Moderation mechanisms and violation handling
How does APIYI ensure data security?	Encrypted transport, minimal storage, access control
What does the -c suffix in model names mean?	Marks a different route with different billing

🌐 Network & Connection (11)

Question	One-line answer
Do I Need a Proxy to Use the API?	Direct connection works; no proxy or VPN needed
Python Raises SSLEOFError but curl Works?	OpenSSL 3.5+ post-quantum handshakes get cut by middleboxes
Where are APIYI’s Servers? Which Server Should I Choose?	Node locations, latency testing, and purchase advice
CDN Image/Video Downloads Slow or Timing Out — What to Do?	Self-check commands + what to send us
Is http the Same as HTTP/1.1?	No; most users should just use https
How Can I Reduce Image API Latency?	Client protocol version, connection reuse, and timeouts
Website or API Returns 502 — What Should I Do?	Brief container auto-restart; recovers in ~1 minute, never billed, retry after 30s
Script Gets 502 but Nothing in the Call Logs?	Empty 502 from a local proxy; make the script bypass the system proxy
Image Calls Drop After About 90 Seconds Behind a Proxy?	The proxy closes idle connections; route api.apiyi.com directly
Image Request Hangs With No Result, but the Log Shows a Write Failure?	The direct line cannot carry large images; route image requests through the proxy
How do I avoid API timeouts?	Raise the client timeout; reasoning models are slow

Question	One-line answer
How to keep your account secure? Bind 2FA and a Passkey	Add a second factor; a leaked password alone can’t sign in
Which email providers does APIYI support for registration?	Gmail, Outlook, Foxmail and university addresses
How do I sign in with a Passkey?	Bind once, then use fingerprint or face unlock
GitHub Login Shows ‘Account Already Bound’?	That GitHub account is bound to another email
What If I Forgot My Password?	Reset by email or ask support for help
Why is my API Key invalid?	A mismatched Base URL and KEY is the usual cause
How Do I Delete My Account?	One-click deletion; data cannot be recovered

💬 Still Stuck?

Use Cases

Integration guides for Cherry Studio, Claude Code, Cursor and more

Model Pricing

Live pricing table and detail pages for every model

Live Updates

Daily updates on model status, supply changes, and incidents

Announcements

New model launches, price changes, and feature updates

Still no luck? Reach us directly:

📧 Email: [email protected]
🌐 Console: api.apiyi.com
💰 Pricing: Pricing page

If your question isn’t covered, send it to support — we review suggestions and add them to the FAQ. New users get free trial credits, so you can validate your integration before topping up.

​🚀 Getting Started in 3 Steps

Step 1: Register

Step 2: Create a KEY

Step 3: Make an API Call

​🔥 Top Questions

How to create a KEY?

How to keep your account secure?

Why is my API Key invalid?

Why can't I run requests with a balance?

What does the model multiplier mean?

What recharge promotions are available?

​🔧 Troubleshooting by Symptom

​📖 Documentation Guides

API Integration

Model Selection

Image and Video Generation

Clients and Agents

​📚 Browse by Topic

​🧭 Site Features (4)

​🔑 Tokens & Logs (14)

​🏢 Enterprise Services (9)

​💰 Billing & Security (18)

​🌐 Network & Connection (11)

​👤 Account & Login (7)

​💬 Still Stuck?

Use Cases

Model Pricing

Live Updates

Announcements

🚀 Getting Started in 3 Steps

🔥 Top Questions

🔧 Troubleshooting by Symptom

📖 Documentation Guides

📚 Browse by Topic

🧭 Site Features (4)

🔑 Tokens & Logs (14)

🏢 Enterprise Services (9)

💰 Billing & Security (18)

🌐 Network & Connection (11)

👤 Account & Login (7)

💬 Still Stuck?