apiz

API 网关服务，提供数百种 AI 模型的访问（包括图像生成、视频生成、音频处理、对话等）。使用 apiz CLI 进行模型查询、文档查看和生成任务提交。当用户需要生成图片/视频/音频、查询 AI 模型、语音合成、语音克隆、音乐生成、视频解析、字幕制作、或使用 apiz AI 网关时触发。

跳到安装

仓库: liangdabiao/apiz-skill
最近来源活动: 2026年8月1日 05:13
检测到的 SKILL.md 语言: 中文
星标: 24
分支: 7

安装方式

默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。

用 Codex 或 Claude 帮你安装复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。

直接命令不会经过审查 Prompt；运行前请先检查来源。

npx skills add https://github.com/liangdabiao/apiz-skill --skill apiz

命令会保持在同一行。复制前请横向滚动并检查完整内容。

想先保存到本地？可下载 SkillsMP 当前能够提供的文件。

检查来源文件

决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。

文件资源管理器

7 个文件

SKILL.md

来源说明 · 只读预览

返回搜索返回安装

apiz-use

场景化指导agent使用apiz完成电商作图、视频生成、角色设计、图片本地化等实际任务，包含可复制的命令模板、提示词框架和避坑指南

2026-08-01

查看这个仓库的全部 Skills

name	apiz
description	API 网关服务，提供数百种 AI 模型的访问（包括图像生成、视频生成、音频处理、对话等）。使用 apiz CLI 进行模型查询、文档查看和生成任务提交。当用户需要生成图片/视频/音频、查询 AI 模型、语音合成、语音克隆、音乐生成、视频解析、字幕制作、或使用 apiz AI 网关时触发。

Apiz CLI 完全参考

全局参数

所有命令共享以下全局 flags：

Flag	环境变量	说明
`--api-key`	`APIZ_API_KEY`	Bearer token (sk-...)
`--base-url`	`APIZ_BASE_URL`	后端地址（默认 https://api.apiz.ai）
`--timeout`	`APIZ_TIMEOUT`	请求超时（如 30s, 2m）
`--max-retries`		重试次数（默认 2）
`--profile`		配置文件名
`--config`		配置文件路径覆盖
`--json`		JSON 输出
`--yaml`		YAML 输出
`--table`		表格输出

所有命令速查

命令	功能	是否需要 API Key
`apiz auth login --api-key <key>`	登录	否（写入配置）
`apiz account balance`	查余额	是
`apiz account checkin`	每日签到（随机 50-150 积分）	是
`apiz models list --category <cat>`	列出模型（image/video/audio）	否
`apiz models info <id> --lang zh`	模型元数据 + 参数 schema	否
`apiz models docs <id> --lang zh`	模型文档教程	否
`apiz generate <prompt> --model <id>`	提交生成任务	是
`apiz tasks get <task-id>`	查询任务状态	是
`apiz tasks wait <task-id>`	等待任务完成	是
`apiz voices list`	列出可用音色	是
`apiz speak <text> --voice <id>`	语音合成（TTS）	是
`apiz align <text> --audio <url>`	强制对齐（字幕打轴）	是
`apiz parse <share-url>`	视频链接解析（去水印）	否
`apiz transfer <url> --type <type>`	URL 镜像到 apiz CDN	否
`apiz upload <file>`	上传本地文件到 CDN	是

generate 生成命令详解

apiz generate "<prompt>" [flags]

全部参数

参数	类型	说明	适用场景
`--model`	string	必填。模型 ID	全部
`--wait`	bool	阻塞等待任务完成	全部
`--wait-timeout`	duration	等待超时（默认 10m）	全部
`--interval`	duration	轮询间隔（默认 5s，配合 --wait）	全部
`--json`	bool	JSON 输出	全部
`--aspect-ratio`	string	画面比例（16:9, 9:16, 1:1, 4:3, 3:2）	图片/视频
`--image-size`	string	图片尺寸（square_hd, landscape_16_9, portrait_4_3）	图片
`--image-url`	string	输入图片/音频/视频 URL	图生图/图生视频/音频识别
`--duration`	string	视频时长（秒）	视频
`--params`	string	额外 JSON 参数，合并到请求中	全部

--image-url 用于多种输入场景：图生图、图生视频、声音克隆（输入音频样本）、语音识别（输入音频文件）。--params 可传入任意额外的模型参数，会与标准参数合并。

输出格式

成功时返回：

{
  "task_id": "xxx",
  "status": "completed",
  "model": "openai/gpt-image-2",
  "result": {
    "images": [{
      "url": "https://cdn-hk.51sux.com/...",
      "content_type": "image/png",
      "width": 1122,
      "height": 1402
    }]
  },
  "price": 64,
  "created_at": "2026-07-30 19:28:30",
  "completed_at": "2026-07-30 19:29:15"
}

视频结果中 result 可能包含 video 字段替代 images。失败时 status 为 "failed" 且携带 error 字段。

完整命令参考

1. 安装与登录

# 安装 CLI
curl -fsSL https://apiz.ai/cli | sh

# 写入 API Key 到配置文件
apiz auth login --api-key "sk-xxx"

# 配置文件位置：~/.config/apiz/config.toml

API Key 优先级：--api-key 参数 > APIZ_API_KEY 环境变量 > XSKILL_API_KEY 环境变量 > 配置文件

2. 模型查询

# 按分类列出可用模型
apiz models list --category image --json
apiz models list --category video --json
apiz models list --category audio --json

# 查看模型详情（含参数 schema）
apiz models info image4.0 --lang zh --json

# 查看模型使用教程
apiz models docs image4.0 --lang zh

模型列表字段含义：

id — 模型 ID（用于 generate 的 --model）
name — 中文名称
category — 分类（image/video/audio）
capability — 能力描述
stats.success_rate — 历史成功率
stats.pending_tasks — 排队任务数
stats.processing_tasks — 处理中任务数
isHot — 热门模型标记
pricing — 价格信息

models info 还会返回：

description — 模型详细描述
params_schema — 模型支持的参数 schema
channel — 执行通道

3. 图片生成

# 基础文生图
apiz generate "一只可爱的猫" --model image4.0 --wait --json

# 指定画面比例
apiz generate "山峰日落，4K 画质" --model openai/gpt-image-2 --aspect-ratio "16:9" --wait --json

# 图片编辑（提供输入图片 + 修改描述）
apiz generate "把背景换成沙滩，保留人物" --model openai/gpt-image-2/edit --image-url "https://..." --wait --json

# ChatGPT Images 2.0 高质量生成（成功率 ~97%）
apiz generate "赛博朋克风格的城市夜景" --model openai/gpt-image-2 --wait --json

# Nano Banana Pro（Google 高级版）
apiz generate "水墨风格的山水画" --model fal-ai/nano-banana-pro --wait --json

4. 视频生成

# 文生视频
apiz generate "一只金毛在沙滩上奔跑" --model st-ai/super-seed2-lite --wait --json
apiz generate "日落时分的城市延时摄影" --model fal-ai/kling-video/v3/pro/text-to-video --wait --json

# 图生视频
apiz generate "让这张图片的场景动起来，微风吹过" --model fal-ai/kling-video/v3/pro/image-to-video --image-url "https://..." --wait --json

# 多图参考视频
apiz generate "参考这些图片的风格和构图生成视频" --model apiz/veo3.1/reference-to-video --wait --json

# 动作迁移（参考视频的动作应用到目标）
apiz generate "按参考视频的动作生成" --model fal-ai/kling-video/v3/standard/motion-control --image-url "https://..." --wait --json

# Kling O3 Pro 图生视频（成功率 100%）
apiz generate "让照片变成生动的短视频" --model fal-ai/kling-video/o3/pro/image-to-video --image-url "https://..." --wait --json

# Sora 2 文生视频（OpenAI）
apiz generate "科幻风格的太空站内部" --model apiz/sora-2/text-to-video --wait --json

# Veo 3.1 文生视频（Google 快速版）
apiz generate "野生动物纪录片风格的画面" --model apiz/veo3.1/fast/text-to-video --wait --json

5. 视频处理

# 解析视频分享链接 -> 获取无水印下载地址 (免费)
apiz parse "https://www.douyin.com/video/xxx"

# 返回: platform, title, video_url, cover_url, duration

# URL 镜像到 apiz CDN (免费)
apiz transfer "https://example.com/video.mp4" --type image

# 返回: original_url, cdn_url, type, size_bytes

# 火山 VOD 精细化字幕擦除
apiz generate "" --model volcengine/vod/subtitle-erase --image-url "<视频url>" --wait --json

6. 语音合成 (TTS)

# 列出可用音色
apiz voices list --json

# 语音合成（默认音色）
apiz speak "你好，欢迎使用AI语音合成服务" --json

# 指定音色
apiz speak "今天天气真不错" --voice "<voice-id>" --json

# 指定语速 + 模型
apiz speak "这是一条测试语音" --voice "<voice-id>" --speed 1.2 --model "speech-2.8-hd" --json

# 保存到本地文件
apiz speak "保存这段语音到文件" --output-file "output.mp3"

# TTS 模型选项：
# speech-2.8-hd     - 高清语音（默认）
# speech-2.8-turbo  - 快速语音
# speech-2.6-hd     - 高清语音 v2.6
# speech-2.6-turbo  - 快速语音 v2.6

# 语音设计（创建自定义音色）- 通过 SDK 支持
# SDK: client.voices.design({ prompt: "年轻女性，温柔语气" })

# 声音克隆（基于音频样本）
# CLI: 使用 apiz generate --model minimax/voice-clone --image-url "<样本音频url>"

7. 强制对齐 / 字幕打轴

# 说话字幕对齐
apiz align "如果您没有其他需要举报的话..." \
  --audio "https://example.com/talk.mp3" \
  --mode speech --json

# 唱歌字幕对齐
apiz align "曾经真的以为人生就这样了" \
  --audio "https://example.com/song.mp3" \
  --mode singing --json

# 保存结果到文件
apiz align "文本内容" \
  --audio "https://example.com/audio.mp3" \
  --mode speech \
  --output-file "result.json"

# 对齐参数
# --mode        : speech (默认) | singing
# --punct-mode  : 0 (=> 1), 1, 2, 3
# --interval    : 轮询间隔（默认 2s）
# --wait-timeout: 超时（默认 5m）

# 返回结构
# {
#   "duration": 120.5,
#   "utterances": [{
#     "text": "句子文本",
#     "start_time": 1000,
#     "end_time": 3000,
#     "words": [{
#       "text": "词",
#       "start_time": 1000,
#       "end_time": 1200
#     }]
#   }]
# }

8. 音频识别与音乐生成

# 语音识别（录音文件转文字）
apiz generate "" --model volcengine/speech-to-text/bigmodel-v2 --image-url "<音频文件url>" --wait --json

# 音乐生成
apiz generate "一首轻快的钢琴曲，温暖治愈风格" --model minimax/music-gen --wait --json
apiz generate "电子舞曲，节奏感强，适合运动" --model minimax/music-gen --wait --json

9. 文件上传

# 上传本地文件到 apiz CDN
apiz upload "./image.png"
apiz upload "./audio.mp3" --folder "my-uploads" --remark "demo"

# 上传参数
# --folder       : 存储文件夹（默认 cli-uploads）
# --content-type : MIME 类型（自动检测）
# --remark       : 备注
# --uploader     : 上传者标签

# 返回：public_url, file_key, file_name, file_size, content_type

10. 任务管理

# 查询任务状态
apiz tasks get "task-id-xxx"

# 等待任务完成
apiz tasks wait "task-id-xxx" --interval 3s --wait-timeout 5m

# 任务状态：
# pending    - 排队中
# processing - 处理中
# completed  - 已完成
# failed     - 失败（含 error 信息）

# TaskResponse 完整结构：
# {
#   "task_id": "xxx",
#   "status": "pending|processing|completed|failed",
#   "channel": "api",
#   "model": "model-id",
#   "progress": 0.5,
#   "result": { ... },
#   "queue_info": { ... },
#   "error": "错误信息",
#   "price": 64,
#   "created_at": "2026-07-30 19:28:30",
#   "completed_at": "2026-07-30 19:29:15"
# }

11. 账户管理

# 查余额
apiz account balance

# 每日签到（随机 50-150 积分，每天一次，幂等）
apiz account checkin

模型参考

图片生成模型（6 个）

模型 ID	名称	成功率	说明
`image4.0`	Image 4.0	—	通用图片生成
`openai/gpt-image-2`	ChatGPT Images 2.0	~97%	OpenAI 高质量文生图
`openai/gpt-image-2/edit`	ChatGPT Images 2.0 Edit	~93%	图片编辑，需 `--image-url`
`fal-ai/nano-banana-2`	Nano Banana 2	100%	Google 文生图 v2
`fal-ai/nano-banana-pro`	Nano Banana Pro	~94%	Google 高级文生图
`kapon/gemini-3-pro-image-preview`	Gemini 3 Pro Image Preview	~52%	Gemini 3 Pro 预览版

视频生成模型（24 个）

Kling 系列（快手可灵，fal.ai）

模型 ID	成功率
`fal-ai/kling-video/o3/pro/image-to-video`	100%
`fal-ai/kling-video/v3/standard/text-to-video`	100%
`fal-ai/kling-video/v3/pro/text-to-video`	100%
`fal-ai/kling-video/v2.6/standard/motion-control`	100%
`fal-ai/kling-video/o3/pro/reference-to-video`	~97%
`fal-ai/kling-video/o3/standard/reference-to-video`	~94%
`fal-ai/kling-video/v3/standard/image-to-video`	~94%
`fal-ai/kling-video/v3/pro/image-to-video`	~92%
`fal-ai/kling-video/v3/pro/motion-control`	~82%
`fal-ai/kling-video/o3/standard/image-to-video`	~75%
`fal-ai/kling-video/v3/standard/motion-control`	~69%

Seedance / Super Seed 系列（火山引擎）

模型 ID	成功率	备注
`st-ai/super-seed2-lite`	~52%	🔥热门，轻量版
`st-ai/super-seed2`	—	🔥热门，全能模型
`ark/seedance-2.0`	~19%	🔥热门

Grok Imagine Video 系列（xAI）

模型 ID	成功率
`xai/grok-imagine-video-1.5/text-to-video`	100%
`xai/grok-imagine-video-1.5/reference-to-video`	100%
`xai/grok-imagine-video-1.5/image-to-video`	~57%

Sora 2 系列（OpenAI，APIZ 代理）

模型 ID	能力
`apiz/sora-2/text-to-video`	文生视频
`apiz/sora-2/image-to-video`	图生视频

Veo 3.1 系列（Google，APIZ 代理）

模型 ID	成功率
`apiz/veo3.1/image-to-video`	~70%
`apiz/veo3.1/text-to-video`	—
`apiz/veo3.1/reference-to-video`	—
`apiz/veo3.1/fast/text-to-video`	— 快速版

其他

模型 ID	能力
`volcengine/vod/subtitle-erase`	火山 VOD 精细化字幕擦除

音频模型（7 个）

模型 ID	名称	能力
`minimax/t2a`	海螺语音合成	文字转语音，100%
`minimax/voice-design`	海螺语音设计	自定义音色（SDK）
`minimax/voice-clone`	海螺声音克隆	基于样本克隆，100%
`minimax/music-gen`	海螺音乐生成	AI 作曲
`volcengine/speech-to-text/bigmodel-v2`	火山录音文件识别	语音转文字
`volcengine/captioning/ata-speech`	火山字幕打轴(说话)	说话字幕
`volcengine/captioning/ata-singing`	火山字幕打轴(唱歌)	唱歌字幕

API 兼容模式

apiz 提供 OpenAI 兼容的 /v1/chat/completions 接口：

from openai import OpenAI
client = OpenAI(
    base_url="https://api.apiz.ai/v1",
    api_key="sk-xxx"
)
# 可调用数百种对话模型
response = client.chat.completions.create(
    model="openai/gpt-5.6",
    messages=[{"role": "user", "content": "hello"}]
)

可用对话模型通过 GET https://api.apiz.ai/v1/models 查询，包含 GPT、Claude、Gemini、Qwen、DeepSeek 等数百种。

SDK 方式

apiz 提供官方 SDK：TypeScript (npm install apiz-sdk)、Python (pip install apiz)。

from apiz import Apiz
client = Apiz(api_key="sk-xxx")

# 生成（参数通过 params 字典传入）
result = client.generate(
    model="image4.0",
    params={"prompt": "a cat", "aspect_ratio": "16:9"},
)

# 语音合成（返回 audio_url / duration）
result = client.speak("你好", voice_id="xxx")

# 强制对齐（返回字级时间戳）
result = client.align(
    audio_url="https://...",
    audio_text="歌词文本",
    mode="singing",
)

# 查看余额
balance = client.account.balance()

完整 SDK 方法映射见 references/sdk-api-reference.md。

MCP Server

apiz 提供 MCP Server 可在 Cursor / Claude Desktop 中使用：

{
  "mcpServers": {
    "apiz": {
      "command": "npx",
      "args": ["-y", "apiz-mcp"],
      "env": { "APIZ_API_KEY": "sk-..." }
    }
  }
}

提供 9 个工具：generate, get_result, search_models, guide, account, speak, align, parse_video, transfer_url。完整说明见 references/mcp-server.md。

apiz

来源信息

安装方式

检查来源文件

同仓库更多 Skills

同仓库更多 Skills

Apiz CLI 完全参考

全局参数

所有命令速查

generate 生成命令详解

全部参数

输出格式

完整命令参考

1. 安装与登录

2. 模型查询

3. 图片生成

4. 视频生成

5. 视频处理

6. 语音合成 (TTS)

7. 强制对齐 / 字幕打轴

8. 音频识别与音乐生成

9. 文件上传

10. 任务管理

11. 账户管理

模型参考

图片生成模型（6 个）

视频生成模型（24 个）

音频模型（7 个）

API 兼容模式

SDK 方式

MCP Server

Apiz CLI 完全参考

全局参数

所有命令速查

generate 生成命令详解

全部参数

输出格式

完整命令参考

1. 安装与登录

2. 模型查询

3. 图片生成

4. 视频生成

5. 视频处理

6. 语音合成 (TTS)

7. 强制对齐 / 字幕打轴

8. 音频识别与音乐生成

9. 文件上传

10. 任务管理

11. 账户管理

模型参考

图片生成模型（6 个）

视频生成模型（24 个）

音频模型（7 个）

API 兼容模式

SDK 方式

MCP Server