APIASK 使用说明

基础

准备账号、余额和 Key

所有工具都需要先完成这些准备。

1. 注册账号与充值

登录平台，并准备可用余额。

充值余额

打开充值。
选择金额并付款。
确认余额已更新。

余额没有刷新时先刷新页面；仍未到账时，保留支付记录并联系平台客服。

2. 创建 API Key

Key 创建后请立即复制保存。

进入 API 密钥管理页面。
点击创建 API Key。
填写名称，例如 codex 或 claude-code。
选择对应分组或模型权限。
复制 API Key，并妥善保存。

分组与倍率不同分组对应的模型、稳定性和计费倍率可能不同。

生图接口

图片生成与编辑

生图建议优先使用美国节点；香港节点速度快但禁止生图，调用会超时失败。

模型分组

分组通常在创建或切换 API Key 时选择，请按用途选择对应分组。

1K / 快

Gpt-image2-1k

只能生成 1K 图片，价格便宜，速度快。

透明背景

Gpt-image2-Transparent

只生成 1K 图片，支持透明背景。image-2 不支持时会降级使用 image-1.5 生成。

1K-4K

Gpt-image2

支持生成 1K 到 4K 图片，适合更高分辨率输出。

生成图片请求

常规生图接口使用 /v1/images/generations。下面示例使用透明背景和 PNG 输出。

curl - 生成图片

curl --location --request POST 'https://de.apiask.com/v1/images/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer 你的 APIASK Key' \
--data-raw '{
  "prompt": "生成一个小猪，透明背景",
  "model": "gpt-image-2",
  "size": "1024x1024",
  "quality": "high",
  "response_format": "url",
  "background": "auto",
  "output_format": "png"
}'

编辑图片请求

编辑图片接口使用 /v1/images/edits，参数和创建图片基本一致，额外增加图片上传；最多支持 4 张图片。

curl - 编辑图片

curl --location --request POST 'https://de.apiask.com/v1/images/edits' \
--header 'Authorization: Bearer 你的 APIASK Key' \
--form 'model="gpt-image-2"' \
--form 'image=@"./image-1.png"' \
--form 'image=@"./image-2.png"' \
--form 'prompt="把两张图片合并"' \
--form 'size="1024x1024"' \
--form 'quality="high"' \
--form 'response_format="url"' \
--form 'background="auto"' \
--form 'output_format="png"'

响应示例

响应格式不要写死不同渠道返回格式可能不一致：响应里可能有 url，也可能有 b64_json。即使请求指定 "response_format": "b64_json"，部分渠道仍可能返回 url，业务代码必须同时兼容这两种字段。

response.json

{
  "created": 1780863297,
  "data": [
    {
      "b64_json": "base64",
      "url": "http://108.62.160.69:6060/images/2026/06/07/1780863382_80f73f73539d22ed4fd64afa088a1c6f.png",
      "revised_prompt": "生成一个马斯克，抖音直播带货的图片"
    }
  ]
}

接入建议优先判断 data[0].url 是否存在；没有 URL 时再读取 data[0].b64_json。如果两者都不存在，把完整响应记录到日志方便排查渠道差异。

字段说明

下面按 APIASK 生图接口常用字段整理。不同上游通道可能会收窄可用值，以实际返回为准。

字段	支持值	说明
`model`	gpt-image-2	使用 APIASK 生图模型名。
`prompt`	字符串	必填，描述要生成或编辑的图片内容。
`size`	见下方尺寸表	按 1K / 2K / 4K 档位选择，最终输出会自动规整到合法尺寸。
`quality`	low / medium / high / auto	生成质量。越高通常越慢、成本越高。
`response_format`	url / b64_json	建议使用 url 降低请求时间，但业务代码一定也要兼容 b64_json。
`background`	transparent / opaque / auto	只有 Gpt-image2-Transparent 分组支持 transparent。
`output_format`	png / jpeg / webp	输出格式。透明背景建议用 png。
`image`	文件上传，最多 4 张	仅编辑图片接口使用；multipart/form-data 字段。

size 尺寸表

档位	支持尺寸
1k	`1024x10241152x768768x1152768x10241024x768768x13601360x768`
2k	`2048x20482048x13601360x20481536x20482048x15361152x20482048x1152`
4k	`2048x20483520x23362336x35202480x33123312x24802160x38403840x2160`

size 特殊说明由于模型限制，最终输出会自动规整到合法尺寸：宽高均为 16 的倍数，最大边长 3840px，宽高比不超过 3:1，总像素限制为 655360-8294400。

工具配置

按使用场景配置 Codex 或 Claude Code

Codex 和 Claude Code 仍是主入口。其他工具大多使用 OpenAI-compatible 接口，核心就是 Base URL、API Key 和模型名三项。

Codex 官方工具使用说明

Codex 使用 OpenAI 兼容接口。下面提供两种使用方式。

方式一：通过 CC-Switch 使用（推荐）

先安装 CC-Switch未安装时，从 CC-Switch Releases 下载。

配置项	Codex 推荐填写	说明
名称	`APIASK Codex`	本地识别用。
Base URL	`https://de.apiask.com/v1`	把 `de` 换成要用的节点；Codex 通常带 `/v1`。
API Key	`你的 APIASK Key`	填写刚创建的 Key。
模型	选择平台支持的 OpenAI 兼容模型	以平台可用列表为准。

确认余额和 Key 可用。
从 API Key 管理页快速打开 CC-Switch，或在 CC-Switch 中手动创建 APIASK Codex 配置。
确认 CC-Switch 上的 Codex 配置已经启动。
如果 Codex 已运行，先关闭再重新启动。
打开终端，进入项目目录。
运行 codex 启动官方 Codex 工具。
选择模型并开始使用。

API Key 管理快速打开 CC-Switch — 从 API Key 管理页快速打开 CC-Switch。

方式二：手动配置环境变量

不用 CC-Switch 时，先设置环境变量。

Windows PowerShell

$env:OPENAI_BASE_URL = "https://de.apiask.com/v1"
$env:OPENAI_API_KEY = "你的 APIASK Key"
codex

macOS / Linux

export OPENAI_BASE_URL="https://de.apiask.com/v1"
export OPENAI_API_KEY="你的 APIASK Key"
codex

Claude Code 使用说明

Claude Code 使用 Anthropic/Claude 兼容接口。下面提供两种使用方式。

方式一：通过 CC-Switch 使用（推荐）

与 Codex 分开建配置Claude Code 的 Base URL 通常不带 /v1。

配置项	Claude Code 推荐填写	说明
名称	`APIASK Claude Code`	建议和 Codex 分开命名。
Base URL	`https://de.apiask.com`	把 `de` 换成要用的节点；通常不带 `/v1`。
API Key	`你的 APIASK Key`	填写支持 Claude 模型的 Key。
模型	选择平台支持的 Claude 兼容模型	以平台可用列表为准。

创建支持 Claude 模型的 Key。
从 API Key 管理页快速打开 CC-Switch，或在 CC-Switch 中创建 APIASK Claude Code 配置。
确认配置已启动。
打开终端并进入项目目录。
运行 claude 启动 Claude Code。

方式二：手动配置环境变量

不用 CC-Switch 时，先设置环境变量。

Windows PowerShell

$env:ANTHROPIC_BASE_URL = "https://de.apiask.com"
$env:ANTHROPIC_AUTH_TOKEN = "你的 APIASK Key"
claude

macOS / Linux

export ANTHROPIC_BASE_URL="https://de.apiask.com"
export ANTHROPIC_AUTH_TOKEN="你的 APIASK Key"
claude

更多工具接入

下面这些工具的配置都按 APIASK 节点整理。除特别说明外，OpenAI 兼容工具通常使用 https://de.apiask.com/v1；Gemini / Claude 兼容工具通常使用不带 /v1 的节点地址。

OpenCode Aider OpenClaw Gemini CLI Cursor Continue Cline SillyTavern Open WebUI CC Switch

OpenCode

终端 / 编辑器里的轻量 AI 编程工具，适合用 OpenAI-compatible Provider 接入。

配置文件用户级或项目级 opencode.json / opencode.jsonc

Base URLhttps://de.apiask.com/v1

模型写法apiask/你的模型名

安装与验证

npm install -g opencode-ai
opencode --version

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "apiask": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "APIASK",
      "options": {
        "baseURL": "https://de.apiask.com/v1",
        "apiKey": "你的 APIASK Key"
      },
      "models": {
        "你的模型名": {
          "name": "你的模型名"
        }
      }
    }
  },
  "model": "apiask/你的模型名"
}

保存后重启 OpenCode，通过 /models 查看 APIASK 下的模型是否出现。

Aider

命令行结对编程工具，适合直接在 Git 项目里让模型改代码、补测试。

环境变量OPENAI_API_KEY / OPENAI_API_BASE

Base URLhttps://de.apiask.com/v1

模型写法openai/你的模型名

安装与验证

python -m pip install aider-install
aider-install
aider --version

macOS / Linux

export OPENAI_API_KEY="你的 APIASK Key"
export OPENAI_API_BASE="https://de.apiask.com/v1"
aider --model openai/你的模型名

Windows PowerShell

$env:OPENAI_API_KEY = "你的 APIASK Key"
$env:OPENAI_API_BASE = "https://de.apiask.com/v1"
aider --model openai/你的模型名

如需长期生效，可以把变量写入系统环境变量后重新打开终端。

OpenClaw

本地 AI 网关和 Agent 工作流管理工具，适合把多个模型入口统一到本地网关。

配置文件openclaw.json

Provider IDapiask

Base URLhttps://de.apiask.com/v1

安装与查看配置路径

npm install -g openclaw@latest
openclaw --version
openclaw config file

openclaw.json

{
  "gateway": {
    "mode": "local"
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "apiask/你的模型名"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "apiask": {
        "baseUrl": "https://de.apiask.com/v1",
        "apiKey": "你的 APIASK Key",
        "api": "openai-completions",
        "models": [
          {
            "id": "你的模型名",
            "name": "你的模型名",
            "input": ["text", "image"],
            "contextWindow": 1000000,
            "maxTokens": 32000
          }
        ]
      }
    }
  }
}

启动与验证

openclaw config validate
openclaw models list
openclaw gateway

如果你的模型不支持图片输入，把 input 改成 ["text"]。

Gemini CLI

Gemini 风格命令行助手。接网关时通常填不带 /v1 的基础地址。

环境变量GEMINI_API_KEY / GOOGLE_GEMINI_BASE_URL / GEMINI_MODEL

Base URLhttps://de.apiask.com

模型名你的模型名

安装

npm install -g @google/gemini-cli
gemini --version

macOS / Linux

export GEMINI_API_KEY="你的 APIASK Key"
export GOOGLE_GEMINI_BASE_URL="https://de.apiask.com"
export GEMINI_MODEL="你的模型名"
gemini -m 你的模型名

Windows PowerShell

$env:GEMINI_API_KEY = "你的 APIASK Key"
$env:GOOGLE_GEMINI_BASE_URL = "https://de.apiask.com"
$env:GEMINI_MODEL = "你的模型名"
gemini -m 你的模型名

Gemini CLI 会自行拼接 Gemini API 路径，所以这里不要追加 /v1。

Cursor

AI 原生编辑器。若使用 BYOK/自定义模型方案，核心是填对 URL、Key 和 Model ID。

Base URLhttps://de.apiask.com/v1

API Key你的 APIASK Key

Model ID你的模型名

cursor-byok 填写项

Name: APIASK
Base URL: https://de.apiask.com/v1
API Key: 你的 APIASK Key
Model ID: 你的模型名

测试消息

只回复 OK，不要解释。

保存后完全退出并重新打开 Cursor，再到模型下拉列表里选择刚添加的模型。

Continue

VS Code / JetBrains 的 AI 编程扩展，适合在现有编辑器中接入聊天和代码上下文。

配置文件%USERPROFILE%\.continue\config.yaml 或 ~/.continue/config.yaml

Provideropenai

Base URLhttps://de.apiask.com/v1

config.yaml

name: APIASK
version: 0.0.1
schema: v1
models:
  - name: 你的模型名
    provider: openai
    model: 你的模型名
    apiBase: https://de.apiask.com/v1
    apiKey: 你的 APIASK Key
    useResponsesApi: false

保存后回到 Continue 面板，在 Select model 中选择 APIASK 模型并发送测试消息。

Cline

VS Code 里的任务型 Agent，适合让模型分步骤读项目、改文件和执行命令。

API ProviderOpenAI Compatible

Base URLhttps://de.apiask.com/v1

Model ID你的模型名

配置字段

API Provider: OpenAI Compatible
Base URL: https://de.apiask.com/v1
API Key: 你的 APIASK Key
Model ID: 你的模型名

首次打开选择 Bring my own API key，保存后新建任务发送一句简单测试。

SillyTavern

聊天前端，适合角色卡、长期对话和提示词调试。

API 类型Chat Completion

SourceCustom / OpenAI-compatible

Endpointhttps://de.apiask.com/v1

连接字段

API Type: Chat Completion
Source: Custom (OpenAI-compatible)
Endpoint / API Base URL: https://de.apiask.com/v1
API Key: 你的 APIASK Key
Model: 你的模型名

填写完成后先点击连接按钮，状态有效后再回到聊天页测试。

Open WebUI

网页版 / 桌面版聊天与模型管理界面，适合把 APIASK 接成统一聊天入口。

位置管理员面板 / 设置 / 外部连接

URLhttps://de.apiask.com/v1

认证Bearer Key

外部连接字段

URL: https://de.apiask.com/v1
Auth: Bearer Key
Key: 你的 APIASK Key
API Type: Chat Completions
Model ID Prefix: APIASK
Model ID: 留空自动读取，或填写 你的模型名

保存连接后还要保存设置页，回到聊天页再选择对应模型。

CC Switch

统一管理多个 AI 工具的接口和模型配置，适合在 Codex、Claude Code、Cursor 间切换。

供应商名称APIASK

请求地址https://de.apiask.com/v1

模型名称你的模型名

通用填写项

Provider Name: APIASK
API Key: 你的 APIASK Key
API Request URL: https://de.apiask.com/v1
Model Name: 你的模型名

以 Codex 为例时，保存后 CC Switch 会写入对应配置；其他工具按界面字段调整即可。

连接稳定性建议

长任务建议安装 auto-resume，断流后更容易继续。

Codex 建议安装

安装文档

把下面提示词发给 Codex。

Codex 提示词

Fetch and follow instructions from https://raw.githubusercontent.com/CyberRookie-X/auto-resume/refs/heads/main/.codex-plugin/INSTALL.md

Claude Code 建议安装

安装文档

把下面提示词发给 Claude Code。

Claude Code 提示词

Fetch and follow instructions from https://raw.githubusercontent.com/CyberRookie-X/auto-resume/refs/heads/main/.claude/INSTALL.md

适合先安装 auto-resume 的场景长任务、批量修改、跨文件排查时，建议先装 auto-resume。

常见问题

1. 调用失败或提示无余额怎么办？

检查余额、Key 状态和模型权限。

2. 提示模型不存在怎么办？

确认模型名和当前分组可用模型一致。

3. Base URL 应该带不带 `/v1`？

Codex 通常用 节点地址/v1；Claude Code 通常直接用 节点地址。

4. 为什么推荐 CC-Switch？

它能集中管理 Key、接口和模型，减少反复改环境变量。

准备账号、余额和 Key

1. 注册账号与充值

充值余额

2. 创建 API Key

图片生成与编辑

模型分组

Gpt-image2-1k

Gpt-image2-Transparent

Gpt-image2

生成图片请求

编辑图片请求

响应示例

字段说明

size 尺寸表

按使用场景配置 Codex 或 Claude Code

Codex 官方工具使用说明

方式一：通过 CC-Switch 使用（推荐）

方式二：手动配置环境变量

Claude Code 使用说明

方式一：通过 CC-Switch 使用（推荐）

方式二：手动配置环境变量

更多工具接入

OpenCode

Aider

OpenClaw

Gemini CLI

Cursor

Continue

Cline

SillyTavern

Open WebUI

CC Switch

连接稳定性建议

常见问题

1. 调用失败或提示无余额怎么办？

2. 提示模型不存在怎么办？

3. Base URL 应该带不带 /v1？

4. 为什么推荐 CC-Switch？

3. Base URL 应该带不带 `/v1`？