Tutorial Collection — 300+ AI Agents & Coze (English edition)
Step 1. Go to the official site and register an account (Required reading)
yundare.com homepage: "Unified API gateway, serving massive AI models". Shows a code demo (POST /v1/responses with a Bearer token and model name; response returns output_text "Response workflow ready.", total_tokens 81). Action buttons: Get Started, Pricing, Docs. Featured integrations: Cherry Studio, CC Switch, more. Stats: 50+ upstream model providers, 100+ model computing support, 50+ compatible API routes, 10+ scheduling and fault-tolerance capabilities.Sign-up page titled "Create an Account". Below the heading: "Already have an account? Sign in." Fields: Username, Password (8–20 characters), Confirm Password. Button: Create Account.
Step 1. After registering, use a redemption code to redeem credits (you can also top up online here for renewal)
Wallet page. The "Wallet" item in the sidebar is highlighted (1). Top summary cards: Current Balance $12.33 (remaining credits), Total Usage $17.67 (total consumed), API Requests 13,180 (total request count). The "Add Funds" section (2) shows a field "Enter your redemption code" with a "Redeem Credits" button. Below it (3) a link "Get a redemption code here" — annotated in red: "When credits run out, you can self-recharge here". At the bottom: a Recommended plan referral link s1.a-iii.com/sign-up?aff=LYqWf.
Step 2. Then create a Key — just fill in a name under API Key; the group field is optional
API Keys management page. The "API Keys" item in the sidebar is selected. The table columns are: Name, Status, API Key, Quota, Group, Model, IP Limit, Created, Last used, Actions. One row exists: test / Enabled / sk-39a1…rOH / Unlimited / User Group / Unlimited / 2026-07-02 15:18:20 / 2026-07-02. A red arrow points to the top-right button "+ Create API Key", annotated "Create Key".Create API Key dialog, "Basic Info" section (set the token's basic info). The "Name" field is highlighted in red and shows "CX". Below: Group (select a group), Expiration (Never expires / 00:00 / Never / 1 month / 1 day / 1 hour), Quantity (1). The "Quota Settings" section lets unlimited quota be toggled on for this API key. An "Advanced Settings" section is collapsed. Buttons: Close, Save Changes.
Step 3. Copy the created token key
API Keys page, the same as the previous one, with a red arrow + annotation "Get the created key" pointing at the API Key cell (sk-39a1…) which has a copy icon next to it.
Step 4. You can now configure it wherever you want — e.g. Claude Code, CC Switch, Codex, etc. (When configuring, choose the OPENAI protocol — custom model configuration)
You only need three things: the endpoint + the token + the model name you want to use (check the "Model Square" at https://www.yundare.com/pricing to see which models are available, then copy its name)
Can't connect? How to quickly verify?
Go to the Playground at https://www.yundare.com/playground and select a model. If the model responds normally, the issue is in your client configuration. Otherwise it's a model-routing problem — try another model or contact us for feedback.
Playground page. Sidebar item 1: "Playground" highlighted. The chat shows the assistant greeting: "Hi. What do you need done?" timestamp 11:08:27, response time 3.59s, with copy / refresh / edit / delete actions. Input area 2 labeled "Ask anything". Model selector 3 shows "gpt-5.4-mini default". Send button on the right.
2. Claude Code Configuration
Step 1. First download the latest version of CC Switch (not required, but makes life easier) — CC Switch download URL
API Keys page with the row's "..." action menu opened. Menu items: Copy Key, Copy Connection Info, CC Switch (highlighted in red), Chat, Delete. A red box frames "CC Switch". The "+ Create API Key" button is at the top right.
Select / fill in the relevant connection info
"Fill into CC Switch" dialog. Step 1 — Application radio: Claude / Codex / Gemini. Step 2 — Name field (highlighted in red, "Enter the config name here") shows "My Claude"; helper text: "Press Enter to use 「My Claude」". Below: Haiku model, Sonnet model, Opus model — each with a "Select or enter a model name" dropdown. Step 3 — annotated in red: "Select the model below; preferably match the name, and pick the latest version". Buttons: Cancel, Open CC Switch (step 4).
Import the configuration into CC Switch
CC Switch "Confirm Import Provider Configuration" dialog. Header: "The following configuration will be imported into CC Switch". Rows: Application Type = Claude; Provider Name = a-iii; Official URL = https://s1.a-iii.com; API Endpoint = https://s1.a-iii.com; API Key = sk-S***************; Haiku Model = claude-opus-4-5-20251101; Sonnet Model = claude-sonnet-4-6; Opus Model = claude-opus-4-8; Multimodal Model = claude-opus-4-8. Buttons: Cancel, Import (highlighted in red).
Step 3. After import, click Test and check the status
CC Switch main view. A green toast (red box) reads "a-iii connection OK (250ms)". Two provider cards are listed: OpenAI Official (Codex login) — https://chatgpt.com/codex, and a-iii — https://s1.a-iii.com (In Use). A red box frames the connection-test (waveform) button on the a-iii card.
Step 4. Open the terminal
Claude Code terminal v2.1.139. Banner: "Welcome back! deepseek-v4-flash · API Usage Billing C:\Users\Administrator". Tips: "Run /init to create a CLAUDE.md file with instructions for Claude. Note: You have launched claude in your home directory. For the best exp…". What's new: agent view (Research Preview), /goal command, /scroll-speed command, /release-notes for more. Commands typed: /model "Set model to deepseek-v4-flash"; hi → "Hi! How can I help you today?"; "Cogitated for 28s".
Step 5. The Claude Code graphical plugin for VS Code also works (remember to restart VS Code)
VS Code with the Claude Code extension. Tabs: "Claude Code for VS Code" and "Claude Code". A "Switched to deepseek-v4-flash" status appears at the top. Left sidebar (CLAUDE CODE): + New session, Search sessions. Model picker shows: Default (recommended) deepseek-v4-pro[1m] · $5/$25 per Mtok, kimi-k2.6 (Custom Fable), deepseek-v4-pro (Custom Opus — highlighted), deepseek-v4-flash (Custom Sonnet — ✓), gpt-5.1 (Custom Haiku), deepseek-v4-pro (Custom). Input box: "Ask Claude to edit…" with "Ask before edits" enabled.
Step 6. Configuration issues
Issue 1
(If you encounter this issue, it's because the Claude plugin doesn't support the OpenAI protocol — see image 2 to set the OpenAI protocol and enable routing)
Claude Code v2.1.181 terminal showing an error. "Welcome back! Deepseek-v4-flash · API Usage Billing /Users/jin". Commands run: /model "Set model to Deepseek-v4-flash and saved as your default for new sessions"; then hi. Error displayed: "API Error: 400 2 request validation errors: Input should be a valid string, field: 'messages[1].***.str', value: [{'text': '<system-reminder>\nAs you answer the user's questions, you can use the following context: # currentDate\nToday's date is 2026/06/18.\n\nIMPORTANT: this context may or may not be relevant to your tasks. You should not respond to this context unless it is highly relevant to your task.\n</system-reminder>\n\n', 'type': 'text'}, {'text': '<local-command-caveat>Caveat: The messages below were generated by the user while running local commands. DO NOT respond to these messages or otherwise consider them in your response unless the user explicitly asks you to.</local-command-caveat>\n', 'type': …".
Change the API format to OpenAI protocol
Edit Provider page. Request URL toggle "Complete URL". URL field: https://ai.yxkl.cloud. Helper tip (yellow): "Enter an OpenAI Chat Completions-compatible server endpoint; do not end it with a slash". Advanced Options expanded. API Format (red box): "OpenAI Chat Completions (requires routing enabled)". Helper: "Select the provider API input format". Auth field: ANTHROPIC_AUTH_TOKEN (Default). Helper: "Choose the auth env variable name used by your config".
Enable routing settings and turn on Claude routing
CC Switch Settings page, Routing tab. "Local Routing" panel with a "Running" badge. Toggle "Show local routing switch on the main page". Main routing switch (red box): ON — Running. Routing-enabled apps (red box): Claude ON, Codex OFF, Gemini OFF. Helper: "Select which apps to route; once enabled, requests from those apps will be forwarded through local routing". Service address: http://127.0.0.1:15721 with a Copy button. Note: "Modifying the address or port requires restarting the routing service to take effect". In use: "Current Provider: Waiting for first request…".
Issue 2
Codex chat showing an error toast: "CC Switch local proxy failed while handling Codex endpoint /responses. Provider: My Codex; model: deepseek-v4-pro; upstream_status: HTTP 400; cause: cannot specify both 'thinking' and 'reasoning_effort'".
Step 1. Update to the latest version.
GitHub release Assets list (18 files) for CC-Switch v3.16.3, including Linux arm64/x86_64 .AppImage/.deb/.rpm, macOS .dmg/.tar.gz/.zip, Windows .Portable.zip/.msi, and source archives. Two red arrows annotate the Windows section: 不要用这个 ("Don't use this") → CC-Switch-v3.16.3-Windows-Portable.zip, 用这个 ("Use this") → CC-Switch-v3.16.3-Windows.msi.
Step 2. Switch to Codex's native protocol (no routing needed)
Edit Provider page (advanced view). Yellow tip: "Enter an OpenAI Response-format-compatible server endpoint URL". Advanced Options (red box): Upstream format = "Responses (Native)". Helper note: "If the provider is natively Responses API, choose Responses (direct connect, no format conversion); if it uses the Chat Completions protocol, choose Chat (requires the routing takeover to be enabled to convert to Chat Completions)". Model Mapping table: Display name = Deepseek-v4-flash, Actual request model = Deepseek-v4-flash, Context window = e.g., 128000. Custom User-Agent: Mozilla/5.0… with Presets. Local proxy request override section (Header override / Body override). Buttons: Get model list, Add model, Save.
Step 3. Quit Codex completely — end the process, then reopen it
3. Codex Configuration
Step 1. First download CC Switch (not required, but makes life easier) — CC Switch download URL
API Keys page with the row's "..." action menu opened. Menu items: Copy Key, Copy Connection Info, CC Switch (highlighted in red), Chat, Delete. A red box frames "CC Switch". The "+ Create API Key" button is at the top right.
Select / fill in the relevant connection info
"Fill into CC Switch" dialog. Application: Codex selected. Name: a-iii. Main model*: gpt-5.6-sol — annotated in red: "Just pick the latest GPT model". Buttons: Cancel, Open CC Switch.
Import the configuration into CC Switch
CC Switch "Confirm Import Provider Configuration" dialog. Application Type: Codex. Provider Name: a-iii. Official URL: https://s1.a-iii.com. API Endpoint: https://s1.a-iii.com/v1. API Key: sk-S***************. Model: gpt-5.6-sol. Yellow note: "Please verify the information above is correct before importing. You can edit or delete the entry from the provider list afterwards." Buttons: Cancel, Import (red box).
Step 4. After import, click Test and check the status
CC Switch main view. Green toast (red box): "a-iii connection OK (632ms)". Two provider cards: OpenAI Official (Codex login) — https://chatgpt.com/codex, and a-iii — https://s1.a-iii.com. A red box frames the connection-test button on the a-iii card.
Step 5. Restart Codex to start chatting. [If you're not configuring a GPT-series model, the model field will be blank, but it still works.] [The blank one calls the first model you selected.]
[You need to restart Codex every time you switch models in CC]
Codex desktop app. Top menu: File / Edit / View / Help. Left sidebar: Quick Chat, Search, Plugins, Automation, Projects, Conversations (hi 1/6/7 min ago, "Say hi"). Chat pane: user message "hi" → assistant reply "hi — I'm here. What are we making or untangling today?" A permission prompt at the bottom: "Set up agent sandbox to continue — protect files and control network access", with a Settings button. Composer footer: requires approval, 5.4 high.
ROO CODE / CODEX settings panel. Provider config. Config profile: default. Helper: "Save multiple API configs for quick switching". API Provider: Anthropic (link to provider docs). Anthropic API Key: masked. Helper: "API key is securely stored in VS Code's secret storage". Checkbox: Use custom base URL — enabled, value s1.a-iii.com/. Optional: send Anthropic API key as Authorization header instead of X-Api-Key; enable 1M context window (Beta) — extends Claude Sonnet 4.x / Claude Opus 4.6 context to 1M tokens. Model: claude-sonnet-4-5.
Cherry Studio "Add Provider" dialog. Provider name field placeholder: "e.g. OpenAI". Provider type dropdown: Anthropic (focused, green border). Buttons: Cancel, OK (disabled).Cherry Studio provider config page. Top: "New API" toggle ON. API Key: masked input; "Detect" button on the right; helper "Separate multiple keys with a vertical bar". API Address: https://s1.a-iii.com (highlighted with red strikethrough); "Reset" button (red box). Preview: https://s1.a-iii.com/v1/chat/completions. Models: "Fetch model list" button +. Footer link: "See New API docs for more details".