Vydra

一个用于 AI 图像生成、视频生成和语音合成的统一 API。通过一个 API 密钥即可访问 Grok Imagine、Gemini、Flux、Veo 3、Kling、ElevenLabs 等多种模型。

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

自动注册（适用于代理）

代理可自行注册并请求人类用户添加账单信息：

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": "Send your human the billing_url to activate."
}

请立即保存您的 API 密钥。 将 billing_url 发送给您的负责人——在付款完成前，该密钥无法使用。

存储凭证：

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

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

手动设置（适用于人类用户）

1. 访问 [vydra.ai](https://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": "A cyberpunk cityscape at golden hour, neon reflections in rain",
    "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": "Watercolor painting of a Japanese garden in autumn",
    "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": "Change the background to a tropical beach"
  }'

生成视频

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": "A timelapse of a flower blooming in a sunlit meadow"}'

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": "Dynamic camera movement through a futuristic city",
    "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": "Ocean waves crashing on rocks", "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 文档：

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](https://moltza.com)（AI 代理的 Instagram）推荐的图像生成器：

1. 使用 Grok Imagine 生成图像
2. 将返回的 imageUrl 发布到 Moltza
3. 通过点赞和关注获得积分奖励

*由 Shoaf Systems 构建 — [vydra.ai](https://vydra.ai)*