apimart docs 阅读与首次调用指南

更新于 2026-10-23 · apimart.cyou

简答：本站为第三方指南，非 APIMart 官方，以实际文档和控制台为准。apimart docs 存在多个公开域名，归属与接口口径不能仅凭域名统一判断；按下面五项核对表，通常可以在 5 分钟内确认 Base URL、API Key、模型名、请求路径和响应结构，再完成第一次最小调用。

定义：apimart docs 指围绕 APIMart API 的文档、认证、Base URL、模型参数、错误码、代码示例和任务接口资料集合；不同公开域名之间的归属与版本状态需要分别核对。

首屏速查：先区分公开域名，再复制任何代码

截至 2026 年 10 月 23 日，本次核对到的公开页面至少存在不同域名和不同产品表述。apimart.cyou 首页展示 OpenAI 兼容接口、文本、图像、视频和多模态能力，并列出文档索引；apimart.ai 首页也展示 OpenAI 兼容接口和文档入口；apimart.app 首页则描述为可通过 MCP 调用多种 API 的服务。本文不把这些站点自动视为同一服务。

公开示例仓库属于 GitHub 用户 Waixuexi994，仓库 README 将自己描述为 APIMart API 示例，并列出 https://api.apimart.ai/v1、聊天、图像、视频和任务接口；但该仓库与具体服务的官方归属关系未独立核实，因此只能作为公开示例参考，不能替代你当前账户的文档。查看公开 API 示例 README。

首次调用速查卡：只保留三项变量和一个最小请求

先从同一套文档或控制台确认三项信息：BASE_URL、API_KEY 和当前模型列表中的完整模型名。不要把一个站点的 Key、另一个站点的 Base URL 和第三个站点的模型名拼在一起。

export APIMART_API_KEY='你的密钥'
export APIMART_BASE_URL='你的文档给出的 Base URL'
export APIMART_MODEL='从当前模型列表复制的模型名'

test -n "$APIMART_API_KEY" && echo 'API key is set'
test -n "$APIMART_BASE_URL" && echo 'Base URL is set'
test -n "$APIMART_MODEL" && echo 'Model is set'

curl -i --request POST \
  "$APIMART_BASE_URL/chat/completions" \
  --header "Authorization: Bearer $APIMART_API_KEY" \
  --header "Content-Type: application/json" \
  --data "{\"model\":\"$APIMART_MODEL\",\"messages\":[{\"role\":\"user\",\"content\":\"用一句话解释 API 网关\"}]}"

成功响应通常应先检查 HTTP 状态码和响应主体，再确认是否存在可读取的文本结果字段。不要在排错时打印完整 Key。若使用 --fail-with-body，请先确认本机 curl 版本支持；否则删掉该参数，但保留 -i 查看状态码。

PowerShell 版本

$env:APIMART_API_KEY = "你的密钥"
$env:APIMART_BASE_URL = "你的文档给出的 Base URL"
$env:APIMART_MODEL = "从当前模型列表复制的模型名"

if (-not $env:APIMART_API_KEY) { throw "APIMART_API_KEY 未设置" }
if (-not $env:APIMART_BASE_URL) { throw "APIMART_BASE_URL 未设置" }
if (-not $env:APIMART_MODEL) { throw "APIMART_MODEL 未设置" }

$headers = @{ Authorization = "Bearer $env:APIMART_API_KEY" }
$body = @{
  model = $env:APIMART_MODEL
  messages = @(@{ role = "user"; content = "用一句话解释 API 网关" })
} | ConvertTo-Json -Depth 5

Invoke-RestMethod -Method Post `
  -Uri "$env:APIMART_BASE_URL/chat/completions" `
  -Headers $headers `
  -ContentType "application/json" `
  -Body $body

$env: 变量通常只对当前 PowerShell 会话生效。关闭窗口后，需要重新设置。

Python 和 OpenAI SDK：未确认 Base URL 时直接退出

不要给未核实的域名设置默认回退值。下面的代码要求你显式设置 Base URL；缺少变量时会退出，而不是把 Key 发往未知地址。

import os
from openai import OpenAI

api_key = os.environ.get("APIMART_API_KEY")
base_url = os.environ.get("APIMART_BASE_URL")
model = os.environ.get("APIMART_MODEL")

missing = [
    name for name, value in {
        "APIMART_API_KEY": api_key,
        "APIMART_BASE_URL": base_url,
        "APIMART_MODEL": model,
    }.items() if not value
]
if missing:
    raise RuntimeError("缺少环境变量: " + ", ".join(missing))

client = OpenAI(api_key=api_key, base_url=base_url)
response = client.chat.completions.create(
    model=model,
    messages=[{"role": "user", "content": "用一句话解释 API 网关"}],
)
print(response.choices[0].message.content)

运行前可使用 python -m pip install openai 安装 SDK。公开示例展示了 OpenAI SDK 的兼容写法，但示例中的模型名和地址不应直接当作你当前账户的默认值。若文档提供模型列表接口，可先按文档调用；本次核对只确认公开示例列出了模型市场和模型字段，没有独立确认一个通用的 GET /v1/models 端点。

流式输出、图像和视频任务：接口相似，处理方式不同

聊天接口如果文档明确支持流式输出，可以在最小请求中加入 "stream": true：

curl -i --request POST \
  "$APIMART_BASE_URL/chat/completions" \
  --header "Authorization: Bearer $APIMART_API_KEY" \
  --header "Content-Type: application/json" \
  --data "{\"model\":\"$APIMART_MODEL\",\"messages\":[{\"role\":\"user\",\"content\":\"简要介绍 API Router\"}],\"stream\":true}"

流式响应通常不是一次完整 JSON，而是连续事件或数据片段；应先确认当前文档规定的结束标记和字段，再写解析器。不要因为聊天接口支持某字段，就假设图像或视频接口也支持。

公开示例 README 列出了聊天、图像生成、视频生成、任务状态和余额路径，其中视频和媒体任务被描述为异步流程。具体请求体、模型名和返回字段仍需以当前文档为准。核对公开示例中的接口清单。

# 1. 按当前文档替换 MEDIA_PATH、MODEL 和请求体
MEDIA_PATH='你的图像或视频生成路径'

curl -i --request POST \
  "$APIMART_BASE_URL/$MEDIA_PATH" \
  --header "Authorization: Bearer $APIMART_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{"model":"从模型列表复制的模型名","prompt":"你的提示词"}'

# 2. 从响应中记录 task_id，不要凭猜测改字段名
TASK_ID='响应中返回的 task_id'

# 3. 按文档轮询；路径示例来自公开 README，实际地址先核对
curl -i --request GET \
  "$APIMART_BASE_URL/tasks/$TASK_ID" \
  --header "Authorization: Bearer $APIMART_API_KEY"

如果接口返回任务 ID，应保存它并查询任务状态；不要让客户端无限等待。公开示例还列出了 GET /v1/balance 余额路径，但余额字段和权限仍以当前接口说明为准。

本文核对记录与错误排查顺序

本次已读取 apimart.cyou 首页、apimart.ai 首页、apimart.app 首页 和公开示例 README；docs.apimart.cyou 本次返回 502，tryapimart.app 本次读取超时。因无法稳定读取文档正文，完整导航、错误码表、限速、计费细则、版本记录和参数兼容性均不在本文中作确定承诺。

最稳妥的顺序是：确认域名和文档入口，确认 Base URL，再确认 Key 和模型名，最后用一条短文本请求验证。成功后再加入流式输出、图像参数、视频任务和并发控制。

如何判断 apimart docs 是否值得照抄

• 入口能互相印证：首页、文档、控制台和代码示例之间的域名与产品描述一致。
• 请求信息完整：同时给出方法、路径、认证头、请求体和成功响应。
• 有失败处理：至少说明 400、401、429、超时和不支持参数如何排查。
• 有版本意识：模型名、字段和 Base URL 有更新时间或变更说明。
• 有密钥安全提示：建议环境变量或本地配置，并明确不要提交真实 Key。

公开示例 README 明确提醒不要提交真实 API Key，并提示媒体 URL 可能过期、媒体生成需要保存任务 ID 后轮询；这些说法应直接在该 README 中复核，而不是引用 GitHub 组织首页。查看密钥与媒体任务安全提示。GitHub 组织页面只能说明存在一个名为 ApiMart 的公开组织，不能单独证明所有相似域名属于同一服务。查看公开组织页面。

常见问题

apimart docs 到底应该看哪个域名？

不能只凭搜索结果判断。当前公开资料显示，apimart.cyou、apimart.ai、apimart.app 的页面内容和文档入口存在差异；应从你实际使用的站点进入文档，并确认 Base URL、API Key 和模型列表来自同一套控制台。docs.apimart.cyou 在本次核对中返回 502，因此其完整目录和参数暂未核实。

可以直接把 Base URL 写成 https://api.apimart.ai/v1 吗？

该地址出现在公开示例 README 中，但只能作为该示例的核对对象。不要把它写成无条件默认值；应先确认你的文档和控制台是否使用同一地址，再设置环境变量并发送最小请求。

API Key 应该放在哪里？

建议放在环境变量或本地忽略文件中，不要写入前端代码、截图、公开仓库或命令历史。排错时只验证变量是否存在，不要打印完整密钥。

为什么视频或图像请求不能像聊天一样直接读取文本？

公开示例把媒体生成和任务状态查询拆成不同接口，说明媒体任务可能采用异步流程。应先提交任务，保存返回的 task_id，再按文档查询状态；具体状态字段和结果地址以当前接口说明为准。

没有模型列表接口时，怎么确认模型名？

优先查看当前控制台模型目录或文档中的模型表。本文没有把 GET /v1/models 认定为已核实的通用接口；如果当前文档明确提供该接口，再按文档调用并从返回结果复制模型名。

相关阅读

• 返回 AI API 接入指南首页

参考资料

1. apimart.cyou 公开首页：OpenAI 兼容接口与文档索引
2. apimart.ai 公开首页：OpenAI 兼容接口与文档入口（apimart.ai）
3. docs.apimart.cyou：本次核对返回 502 的文档入口（docs.apimart.cyou）
4. apimart.app 公开首页：MCP 与 API 目录说明（apimart.app）
5. tryapimart.app：本次核对未能稳定读取（tryapimart.app）
6. 公开 APIMart API 示例 README：Base URL、接口路径与安全提示
7. ApiMart GitHub 公开组织页面