图像生成模型集成技能

使用此技能探索并通过 ShortAPI 平台集成所有可用的图像生成模型。

概述

ShortAPI 为多个顶级提供商的图像生成提供了统一的 /api/v1/job/create 接口。本技能概述了所有可用的图像生成模型，并说明如何动态获取调用它们所需的特定 JSON Schema。

• API 端点: https://api.shortapi.ai/api/v1/job/create
• 类别: text-to-image、image-to-image
• 类型: 推理（inference）

可用图像模型

以下是可使用的完整支持的图像生成模型 ID 列表：

如何使用图像模型

由于每个图像模型支持不同的参数（如 aspect_ratio、image_size、guidance_scale，或提示词中内建的高级控制），你需要获取特定模型的 Schema 文档，以构建有效的 API 请求体。

步骤 1：获取特定模型的技能文档（必做）

必须在构造 POST 请求体之前，先获取目标 <model_id>（例如 google/nano-banana-pro/text-to-image）的详细技能文档。请勿跳过此步骤。请勿凭空猜测参数，因为不同模型对同一概念可能使用完全不同的参数名（例如，一个模型使用 aspect_ratio，另一个使用 image_size）。

发送一个 GET 请求至：

https://shortapi.ai/api/skill/<model_id>

（例如：GET https://shortapi.ai/api/skill/google/nano-banana-pro/text-to-image）

该地址将返回一个 Markdown（.md）格式的文本文档，其中包含该模型的精确输入参数 Schema 和代码示例。你必须解析该文档，以确定哪些参数应放入 args 对象中。

步骤 2：构造 JSON 请求体

根据步骤 1 获取的 Schema 文档，构造一个有效的 JSON 请求体。仅包含在步骤 1 中获取的文档中定义的参数。

通常至少需要以下结构：

{
  "model": "<model_id>",
  "args": {
    "prompt": "你的描述性提示词内容..."
    // ...其他由步骤 1 解析出的模型特定必填或可选参数
  },
  "callback_url": "YOUR_OPTIONAL_WEBHOOK_URL"
}

步骤 3：调用统一生成接口

向 API 端点发起 HTTP POST 请求，并在 Authorization 头部包含 Bearer Token。

Bash（cURL）示例

response=$(curl --request POST \
  --url https://api.shortapi.ai/api/v1/job/create \
  --header "Authorization: Bearer $SHORTAPI_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "google/nano-banana-pro/text-to-image",
    "args": {
      "prompt": "一名宇航员骑着马，采用照片级写实风格"
    }
  }')
JOB_ID=$(echo "$response" | grep -o '"job_id": *"[^"]*"' | sed 's/"job_id": *//; s/"//g')

步骤 4：轮询获取生成状态

使用返回的 job_id 轮询查询接口获取任务状态：

curl --request GET \
  --url "https://api.shortapi.ai/api/v1/job/query?id=$JOB_ID" \
  --header "Authorization: Bearer $SHORTAPI_KEY"

安全与隐私合规

• 端点隔离：此技能仅与 https://api.shortapi.ai 进行通信。
• 回调地址锁定：callback_url 参数由用户严格定义，代理不得自动创建或虚构该值。
• 凭证安全：SHORTAPI_KEY 仅用于向官方 API 端点发送授权请求，且绝不能包含在任何回调负载中。

对代理的关键行为要求：

name: Al Image Generation

version: 1.0.3

description: 通过 ShortAPI.ai 提供的 AI 模型生成图像内容。

summary: 使用 SHORTAPI_KEY 验证后，根据指定模型的技能文档构建请求，异步生成图像，并在完成后直接在聊天中展示结果。

使用说明

1. 身份验证优先（SHORTAPI_KEY）：在执行任何其他步骤前，必须检查用户是否已提供 SHORTAPI_KEY。若未提供，必须主动引导用户前往 [https://shortapi.ai](https://shortapi.ai) 获取 API 密钥。 不得接受或使用其他类型的 API 密钥（如 OpenAI、Anthropic 等）；唯一有效的密钥是来自 ShortAPI.ai 的 SHORTAPI_KEY。

1. 获取模型配置文档：在构造任何 API 请求前，必须先完成第一步——从 https://shortapi.ai/api/skill/<model_id> 获取特定模型的技能文档。不得跳过此步骤，不得猜测或虚构参数。该文档返回的内容是模型输入格式的唯一真实依据。

1. 任务启动通知：图像生成需要时间。一旦收到 Step 3 返回的 job_id，必须立即告知用户任务已开始，并释放用户，使其可以继续提问或开启新对话。

1. 后台轮询状态：必须在后台持续静默轮询任务状态。

1. 完成结果推送：当轮询返回成功状态（status: "succeeded"）时，必须主动向用户发送最终生成结果（例如，返回响应体中的图像 URL 列表）。

1. 结果展示规范：

- 不仅提供原始链接，还应直接在聊天中嵌入预览内容。

- 对于图像，使用 Markdown 语法：![描述](image_url) 进行内联显示。

- 对于视频，使用 HTML 标签：<video controls src="video_url"></video> 实现内嵌播放器。

- 对于音频/音乐，使用 HTML 标签：<audio controls src="audio_url"></audio> 实现内嵌播放器。

- 用户应能无需打开新标签页即可直接查看和播放生成内容。