Artgen API 文档

请求发到 https://artgen.net，不是这个文档站。登录后在仪表盘 → API 密钥创建密钥，并且只在服务器端发送该密钥。

本文描述当前 HTTP 约定。modelId 和 styleId 必须来自实时目录，不要自行编造。

认证Copy Anchor Link

POST /api/create 与 POST /api/convert 需要 API 密钥。GET /api/models 与 GET /api/styles 不需要。

用下面任一请求头发送密钥：

Authorization: Bearer $ARTGEN_API_KEY

或：

x-api-key: $ARTGEN_API_KEY

注意：

• 登录 Cookie 不能认证 /api/create 或 /api/convert。
• API 密钥 不能认证账号、仪表盘或后台接口。
• 两个请求头同时出现时必须是同一把密钥。Authorization 格式错误（包括非 Bearer）、密钥含空白或逗号、或两把密钥不一致，都会被拒绝。
• 把密钥放在服务器上。不要写进浏览器前端、公开仓库、提示词、URL、截图或日志。

在仪表盘 → API 密钥创建和管理：名称 1–32 个字符，有效期 30 / 90 / 365 天或永不过期（页面默认 90 天），完整密钥只在创建时显示一次，之后只保存哈希。可以重命名、停用、启用（未过期）或撤销。过期密钥不能再启用。「最近使用」表示最近一次认证成功，不表示出图成功。

GET /api/modelsCopy Anchor Link

列出已发布模型。无需密钥。响应不缓存（Cache-Control: no-store）。

curl --silent --show-error --include --proto '=https' \
  'https://artgen.net/api/models'

必须拿到 HTTP 200 且为 JSON。不要加 -L 跟随重定向，也不要把 HTML 页面当成成功。

200

{
  "models": [
    {
      "id": "published-model-id",
      "name": "显示名称",
      "description": "公开描述",
      "supportsText": true,
      "supportsTransfer": false,
      "supportsInlineOutput": true,
      "sizes": [{ "value": "1024x1024", "label": "1:1" }],
      "maxPromptLength": 1600,
      "sourceImageMaxDimension": 511
    }
  ]
}

500 — 目录加载失败时返回 { "error": "server_error" }。

GET /api/stylesCopy Anchor Link

返回目录中的全部风格。无需密钥。不分页。不包含内部提示词。响应不缓存（Cache-Control: no-store）。

curl --silent --show-error --include --proto '=https' \
  'https://artgen.net/api/styles'

可选查询参数：locale（en 或 zh-CN）。省略时默认为 en。其他值返回 400 { "error": "invalid_locale" }。

200

{
  "styles": [
    {
      "id": "style-id",
      "dimension": "2d",
      "name": "风格名称",
      "description": "公开描述"
    }
  ]
}

POST /api/createCopy Anchor Link

按文字生成图片。服务端将 mode 设为 text。需要已发布且 supportsText 为 true 的模型。

请求头： Authorization: Bearer … 或 x-api-key，以及 Content-Type: application/json。

请求体字段（未知字段会被拒绝）：

curl --silent --show-error --include --proto '=https' \
  --request POST \
  --header "Authorization: Bearer $ARTGEN_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{"modelId":"id-from-models","prompt":"A quiet mountain lake at sunrise, watercolor"}' \
  'https://artgen.net/api/create'

POST /api/convertCopy Anchor Link

按参考图转换。服务端将 mode 设为 transfer。需要已发布且 supportsTransfer 为 true 的模型。

请求头： 与创作接口相同。

请求体字段（未知字段会被拒绝）：

curl --silent --show-error --include --proto '=https' \
  --request POST \
  --header "Authorization: Bearer $ARTGEN_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{"modelId":"id-from-models","prompt":"A quiet mountain lake at sunrise, watercolor","sourceImage":"data:image/png;base64,..."}' \
  'https://artgen.net/api/convert'

成功响应Copy Anchor Link

创作与转换成功时形状相同。仅当模型返回宽高时才包含 width 和 height。

{
  "success": true,
  "requestId": "uuid",
  "data": {
    "imageUrl": "data:image/jpeg;base64,...",
    "model": "显示名称",
    "modelId": "published-model-id"
  }
}

imageUrl 可能是 base64 data URL，也可能是 HTTPS 图片地址，请当作私密内容处理。生成响应带有 X-Request-Id（与 requestId 相同）和 Cache-Control: no-store。

没有幂等键、任务 id 或状态查询接口。每一次 POST 都是新请求。requestId 只用于排查，不能用来去重重试。

错误Copy Anchor Link

创作与转换的错误体是 { "error": "<code>", "requestId": "<uuid>" }，并带 X-Request-Id 与 Cache-Control: no-store。目录接口错误只有 { "error": "<code>" }。

向支持求助时请提供 HTTP 状态码和 requestId。不要发送 API 密钥、提示词、原始请求体或原始图片。

接下来Copy Anchor Link

• 创建密钥：仪表盘 → API 密钥
• 模型说明：怎么选模型