> ## Documentation Index
> Fetch the complete documentation index at: https://docs.laozhang.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 老张API 文档：AI 模型 API 接入、价格与调用示例

> 老张API接入从这里开始：创建令牌、选择模型、发送第一个请求，并查看文本、图像、视频模型的调用示例、价格与计费说明。

老张API是新加坡公司 YingTu Technology Pte. Ltd. 自 2025 年起运营的 AI API 网关：用一个老张API密钥，即可调用 Google Nano Banana、OpenAI GPT Image、xAI Grok Imagine 等图像模型，以及多家厂商的文本和视频模型。开始只需三步：创建令牌、选择模型、发送第一个请求。

<Note>
  **老张API（laozhang.ai）由新加坡公司 YingTu Technology Pte. Ltd. 运营，注册与服务可用性以企业白名单审核为准。**

  * 仅支持 Gmail 邮箱[注册](https://api.laozhang.ai/register)。
  * 企业用户如需注册，请发送邮件至 [hi@laozhang.ai](mailto:hi@laozhang.ai) 联系客服申请开通白名单。
</Note>

| 项目 | 内容 |
| - | - |
| 请求域名 | `https://api.laozhang.ai` |
| OpenAI SDK Base URL | `https://api.laozhang.ai/v1` |
| 支持的协议 | OpenAI 兼容接口、Anthropic Messages、Gemini 原生协议 |

<Steps>
  <Step title="创建令牌">
    登录[老张API控制台](https://api.laozhang.ai)，在[令牌管理](https://api.laozhang.ai/token)创建令牌（即 API Key）。令牌分组决定可以调用哪些模型，说明见[计费说明](/pricing)。还没有账号时，按页首说明注册。
  </Step>

  <Step title="选择模型">
    在[模型与价格总表](/models)复制完整的模型 ID，并确认它可以在令牌所属的分组调用。
  </Step>

  <Step title="发送第一个请求">
    把密钥设为环境变量，然后用 `gpt-5.4-mini` 发送一条消息：

    ```bash theme={null}
    export LAOZHANG_API_KEY="替换为你的老张API密钥"

    curl https://api.laozhang.ai/v1/chat/completions \
      -H "Authorization: Bearer $LAOZHANG_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "model": "gpt-5.4-mini",
        "messages": [{"role": "user", "content": "请只回复：连接成功"}]
      }'
    ```

    回复文本位于响应的 `choices[0].message.content`。SDK 配置、其他协议和图片示例见 [API 开发文档](/api-manual)。
  </Step>
</Steps>

## 热门入口

<CardGroup cols={3}>
  <Card title="Nano Banana API" icon="banana" href="/api-capabilities/nano-banana-image">
    Google Gemini 图像模型：五个模型的单价、分辨率与 Gemini 原生调用
  </Card>

  <Card title="GPT Image 2.5 API" icon="image" href="/api-capabilities/gpt-image-2-5">
    OpenAI 图像模型：官转与按次线路、生成、编辑与透明背景
  </Card>

  <Card title="Grok Imagine API" icon="wand-sparkles" href="/api-capabilities/grok-imagine-image">
    xAI 图像模型：每张 \$0.055，1K/2K 生成与三图编辑
  </Card>

  <Card title="图像模型选型与价格" icon="compass" href="/api-capabilities/image-generation-guide">
    对比在售图像模型的端点、计费与价格，再进入各模型页
  </Card>

  <Card title="OpenAI 协议" icon="message-circle" href="/api-reference/chat-completions">
    Chat Completions 的请求格式、参数与响应字段
  </Card>

  <Card title="Gemini 协议" icon="sparkles" href="/api-reference/gemini">
    原生 generateContent 请求与 Google Gen AI SDK
  </Card>

  <Card title="Wan 2.7 视频" icon="clapperboard" href="/api-capabilities/wan-video-generation">
    提交视频任务、轮询结果并下载视频
  </Card>

  <Card title="Seedance 2.0 视频" icon="film" href="/api-capabilities/seedance2-video-generation">
    多模态视频生成、预扣费与对账说明
  </Card>

  <Card title="模型与价格" icon="list" href="/models">
    当前在线模型的 ID、单价与可用分组
  </Card>

  <Card title="计费说明" icon="badge-dollar-sign" href="/pricing">
    按量与按次计费、令牌分组、充值与发票
  </Card>

  <Card title="网站公告" icon="megaphone" href="/changelog">
    新模型上线、价格调整与服务状态变化
  </Card>

  <Card title="工具接入" icon="plug" href="/scenarios">
    在 Codex CLI、Gemini CLI、Cline、Cherry Studio 等工具中使用老张API
  </Card>
</CardGroup>

## 让 AI 编程助手读取文档

把下面的地址交给 AI 编程助手，再说明要使用的模型和要完成的任务。API Key 仍放在本地环境变量中，不要粘贴到对话里。

* [skill.md](https://docs.laozhang.ai/skill.md)：写给 AI 编程助手的英文接入说明，只需要完成接入时优先使用。内容包括各 SDK 的 Base URL、密钥读取方式、三种协议（OpenAI 兼容接口、Gemini、Anthropic Messages）的请求示例和常见错误排查。
* [llms-full.txt](https://docs.laozhang.ai/llms-full.txt)：本站公开文档合并成的单个纯文本文件，适合需要一次读取全部资料的工具。文件较大，按需使用。

## 服务主体与联系方式

老张API（laozhang.ai）由新加坡公司 YingTu Technology Pte. Ltd. 运营，面向企业与开发者提供 AI 模型 API 接入服务，不面向公众提供内容生成服务。老张API不是 OpenAI、Google、xAI 等模型厂商的官方服务；调用结果的使用与合规由使用方负责。

| 项目 | 内容 |
| - | - |
| 运营主体 | YingTu Technology Pte. Ltd.（新加坡），2025 年起运营 |
| 付款方式 | 预付余额；Stripe 银行卡支付，企业可对公转账 |
| 服务状态 | [服务状态页](https://api.laozhang.ai/uptimeStatus)，变更见[网站公告](/changelog) |
| 数据处理 | [数据政策](https://www.laozhang.ai/zh-cn/data-policy)：默认不存储请求与响应正文 |
| 服务、计费与退款 | [用户协议](https://www.laozhang.ai/zh-cn/terms) |

运营主体、模型来源、线路、付款与退款规则的完整说明见[平台信息](/about)。

* 邮件：[hi@laozhang.ai](mailto:hi@laozhang.ai)
* Telegram 客服：[@laozhang\_cn](https://t.me/laozhang_cn)
* 公告频道：[@laozhang\_ai](https://t.me/laozhang_ai)
* 产品官网：[www.laozhang.ai](https://www.laozhang.ai)
* 技术博客：[blog.laozhang.ai](https://blog.laozhang.ai)

## 常见问题

### 需要分别注册各家模型的官方账号吗？

不需要。使用老张API密钥即可调用各厂商的模型；可以调用哪些模型，以[模型与价格总表](/models)和控制台为准。

### 已有的 OpenAI SDK 应用怎样切换到老张API？

保留原来的方法调用，把 API Key 换成老张API密钥、Base URL 换成 `https://api.laozhang.ai/v1`，模型 ID 换成总表中的完整 ID。其他注意事项见[迁移已有 OpenAI 应用](/api-manual#迁移已有-openai-应用)。

### 怎么收费，在哪里看价格？

老张API采用预付余额，按实际调用扣费：文本等模型按 token 用量计费，多数图像模型按次计费。

* 各模型单价：[模型与价格总表](/models)
* 每次请求的扣费：控制台[调用日志](https://api.laozhang.ai/log)
* 令牌分组倍率与计费模式：[计费说明](/pricing)

### 应该使用哪个 API 域名？

默认使用 `https://api.laozhang.ai`；三个域名使用同一个 API Key，切换时只改域名，见[开发文档](/api-manual)。

* 默认：`https://api.laozhang.ai`，OpenAI SDK 的 Base URL 为 `https://api.laozhang.ai/v1`
* 服务器在欧美、需要直连：`api-vip.laozhang.ai`
* `api.laozhang.ai` 无法访问时：`api2.laozhang.ai`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.