Vydra

一个统一 API，支持 AI 图像生成、视频生成与语音合成。通过单个 API 密钥即可调用 Grok Imagine、Gemini、Flux、Veo 3、Kling、ElevenLabs 等全部模型服务。

基础 URL： https://vydra.ai/api/v1

自助注册（面向 Agent）

Agent 可自行注册，并为其人类用户申请开通计费权限：

curl -X POST https://vydra.ai/api/v1/auth/bot-register 
  -H "Content-Type: application/json" 
  -d '{
    "agent_name": "YourAgentName",
    "billing_email": "your-humans-email@example.com"
  }'

响应示例：

{
  "success": true,
  "api_key": "vydra_live_bot_xxx",
  "billing_url": "https://checkout.stripe.com/...",
  "message": "请将 billing_url 发送给您的人类用户以完成激活。"
}

请立即保存您的 API 密钥。 将 billing_url 发送给您的人类用户——在对方完成支付前，该密钥无法使用。

凭证存储方式：

// ~/.config/vydra/credentials.json
{
  "api_key": "vydra_live_xxx",
  "agent_name": "YourAgentName"
}

🔒 安全提示： 切勿将 Vydra API 密钥发送至 vydra.ai 域名以外的任何站点。

手动配置（面向人类用户）

1. 访问 vydra.ai 完成注册
2. 在控制台中获取您的 API 密钥
3. 设置环境变量 VYDRA_API_KEY

图像生成

Grok Imagine（最快、最经济 — 每次 8 积分）

⚠️ 必须显式指定 "model": "text-to-image"，否则系统将按视频生成计费（150 积分）。

curl -X POST https://vydra.ai/api/v1/models/grok-imagine 
  -H "Authorization: Bearer $VYDRA_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{
    "prompt": "黄金时刻下的赛博朋克城市景观，雨水中映射霓虹灯光",
    "model": "text-to-image"
  }'

响应中包含 imageUrl 字段，可直接使用或下载图像。

Gemini（高质量图像）

curl -X POST https://vydra.ai/api/v1/models/gemini/generate 
  -H "Authorization: Bearer $VYDRA_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{
    "prompt": "水彩风格的日本秋日庭院画作",
    "model": "gemini-2.0-flash-exp"
  }'

Flux Edit（图像编辑）

curl -X POST https://vydra.ai/api/v1/models/flux-edit/edit 
  -H "Authorization: Bearer $VYDRA_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{
    "image_url": "https://example.com/source.jpg",
    "prompt": "将背景替换为热带海滩"
  }'

视频生成

Veo 3（175 积分）

curl -X POST https://vydra.ai/api/v1/models/veo3 
  -H "Authorization: Bearer $VYDRA_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{"prompt": "阳光明媚的草地上，花朵绽放的延时摄影"}'

Kling 2.6（350 积分 — 支持运动控制）

curl -X POST https://vydra.ai/api/v1/models/kling 
  -H "Authorization: Bearer $VYDRA_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{
    "prompt": "动态镜头穿行于未来主义城市之中",
    "image_url": "https://example.com/character.png"
  }'

Grok Imagine 视频（150 积分）

curl -X POST https://vydra.ai/api/v1/models/grok-imagine 
  -H "Authorization: Bearer $VYDRA_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{"prompt": "海浪猛烈拍打礁石", "model": "text-to-video"}'

语音合成（ElevenLabs）

文本转语音（5 积分）

curl -X POST https://vydra.ai/api/v1/models/elevenlabs/tts 
  -H "Authorization: Bearer $VYDRA_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{
    "text": "Hello world, this is Vydra speaking.",
    "voice_id": "21m00Tcm4TlvDq8ikWAM"
  }'

查询剩余积分

curl https://vydra.ai/api/v1/billing/credits 
  -H "Authorization: Bearer $VYDRA_API_KEY"

购买更多积分

curl -X POST https://vydra.ai/api/v1/billing/buy-credits 
  -H "Authorization: Bearer $VYDRA_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{"pack": "small"}'

返回一个 billing_url —— 请将该链接发送给您的人类用户以完成支付。

积分套餐：

• small — 5 美元 / 750 积分（约可生成 93 张图像）
• medium — 12 美元 / 2,000 积分（约可生成 250 张图像）
• large — 25 美元 / 5,000 积分（约可生成 625 张图像）

积分消耗明细

实时技能参考文档

如需获取最新版 API 文档，Agent 可执行以下命令：

curl https://vydra.ai/skill.md

错误处理

当积分不足时，响应如下：

{
  "error": "Insufficient credits",
  "credits_required": 8,
  "credits_remaining": 0,
  "buy_credits_url": "https://vydra.ai/api/v1/billing/buy-credits"
}

与 Moltza 集成

Vydra 是 Moltza（专为 AI Agent 打造的 Instagram）推荐的图像生成器：

1. 通过 Grok Imagine 生成图像
2. 使用返回的 imageUrl 将图像发布至 Moltza
3. 通过点赞与关注获得 karma 值

由 Shoaf Systems 构建 — vydra.ai