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

# AGICTO API 文档

> 使用 AGICTO API 调用模型、图片、视频、工具和语音接口

AGICTO API 让你通过统一的 Base URL 和 API Key 调用模型能力。你可以使用 OpenAI 兼容格式接入聊天、嵌入、图片和视频接口，也可以按任务调用 Midjourney、联网搜索、发票识别、TTS 和官方视频接口。

<CardGroup cols={3}>
  <Card title="5 分钟跑通调用" icon="rocket" href="/quickstart">
    从 API Key、Base URL 到第一条 Chat completions 请求。
  </Card>

  <Card title="OpenAI 兼容格式" icon="code" href="/guides/openai-compatible">
    迁移 OpenAI SDK，最少只改 API Key、Base URL 和模型名。
  </Card>

  <Card title="模型与价格" icon="boxes-stacked" href="/guides/models">
    查看模型类型、价格字段、上下文长度和选型建议。
  </Card>
</CardGroup>

## 你可以完成什么

<CardGroup cols={2}>
  <Card title="调用文本模型" icon="message" href="/api-reference/model/chat/message">
    使用 `/v1/chat/completions` 构建对话、代码生成和文本处理功能。
  </Card>

  <Card title="流式输出" icon="bars-staggered" href="/guides/streaming">
    让聊天、代码和长文本生成边返回边渲染。
  </Card>

  <Card title="函数调用" icon="plug" href="/guides/function-calling">
    让模型生成结构化工具参数，接入你的业务系统。
  </Card>

  <Card title="视觉理解" icon="eye" href="/guides/vision">
    处理图片问答、截图分析、票据和多模态任务。
  </Card>

  <Card title="选择模型" icon="sliders" href="/guides/model-selection">
    按成本、速度、上下文、代码、图像和视频场景选择模型。
  </Card>

  <Card title="模型厂商" icon="building" href="/guides/model-providers">
    按 OpenAI、Google、DeepSeek、豆包、可灵、Vidu 等厂商理解模型来源。
  </Card>

  <Card title="生成图片" icon="image" href="/guides/image-generation">
    使用 OpenAI 兼容格式或专用图片接口生成图片。
  </Card>

  <Card title="生成视频" icon="video" href="/guides/video-workflow">
    创建视频任务、轮询状态，并在完成后下载结果。
  </Card>

  <Card title="AI 编程工具验证状态" icon="terminal" href="/ai-tools/overview">
    查看已实测的 AGICTO API 基础接口，以及待端到端验证的工具配置。
  </Card>

  <Card title="查询余额" icon="wallet" href="/api-reference/account/balance">
    调用账户接口，确认调用前的余额状态。
  </Card>

  <Card title="接口总览" icon="book-open" href="/api-reference/introduction">
    查看从 Apifox 同步的完整接口列表和请求示例。
  </Card>

  <Card title="排查错误" icon="circle-question" href="/guides/troubleshooting">
    处理 API Key、余额、限速、模型名和任务状态问题。
  </Card>
</CardGroup>

## 应用集成

<CardGroup cols={2}>
  <Card title="LangChain" icon="link" href="/integrations/langchain">
    在 LangChain 中配置 AGICTO API 的 OpenAI 兼容模型。
  </Card>

  <Card title="Dify" icon="diagram-project" href="/integrations/dify">
    在 Dify 中添加 OpenAI-compatible 模型供应商。
  </Card>

  <Card title="Open WebUI" icon="display" href="/integrations/open-webui">
    将 AGICTO API 配置为 OpenAI API 连接。
  </Card>

  <Card title="Flowise" icon="nodes" href="/integrations/flowise">
    用可视化节点构建聊天、RAG 和自动化工作流。
  </Card>
</CardGroup>

## 调用前你需要知道

所有公共接口都围绕这三项展开：

* **Base URL**：`https://api.agicto.cn/v1/`
* **API Key**：在请求 Header 中使用 `Authorization: Bearer $API_KEY`
* **OpenAI 兼容格式**：优先用于聊天、嵌入、图片和视频等常见场景

<Tip>
  如果你已经有 OpenAI SDK 项目，先读 <a href="/guides/openai-compatible">OpenAI 兼容格式</a>。你通常只需要替换 Base URL、API Key 和模型名。
</Tip>

## 推荐阅读顺序

<Steps>
  <Step title="完成第一次调用">
    跟随 <a href="/quickstart">快速开始</a> 创建请求，并确认你的 API Key 可以正常工作。
  </Step>

  <Step title="选择接入方式">
    如果你已有 OpenAI SDK 项目，使用 <a href="/guides/openai-compatible">OpenAI 兼容格式</a>。如果你还没确定模型，先读 <a href="/guides/model-selection">如何选择模型</a>。
  </Step>

  <Step title="查接口细节">
    在 <a href="/api-reference/introduction">API reference</a> 中查看每个接口的 method、path、Header 和请求体。
  </Step>
</Steps>
