跳转至

API 手册

欢迎使用 TweAPI 接口文档。本文档提供了所有可用 API 端点的详细说明。

Base URL

API 端点: https://agent.tweapi.com

认证方式

Gemini 格式 - URL 参数认证：

?key=<YOUR_API_KEY>

可用接口

Gemini 格式

文本生成

方法 端点 说明
POST /v1beta/models/{model}:generateContent 生成内容
POST /v1beta/models/{model}:streamGenerateContent 流式生成内容

图片生成（Gemini）

方法 端点 说明
POST /v1beta/models/gemini-2.5-flash-image:generateContent 快速图片生成
POST /v1beta/models/gemini-3-pro-image-preview:generateContent 高分辨率图片生成

OpenAI 格式

图片生成（GPT Image 2）

方法 端点 说明
POST /v1/images/generations 图片生成
POST /v1/images/edits 图片编辑（需传参考图）

视频生成

方法 端点 说明
POST /v1/videos Omni 视频生成（文生视频/图生视频/视频修改）
GET /v1/videos/{task_id} 查询 Omni 任务状态
POST /v1/videos Veo 视频生成（文生视频/图生视频/帧插值）
GET /v1/videos/{task_id} 查询 Veo 任务状态

快速开始

发送第一个请求

from google import genai

# 直接在 Client 中设置自定义 base URL
client = genai.Client(
    api_key="YOUR_API_KEY",
    http_options={"base_url": "https://agent.tweapi.com"}
)

response = client.models.generate_content(
    model="gemini-3-pro-preview",
    contents="Write a story about a magic backpack.",
)

print(response.text)

import requests

BASE_URL = "https://agent.tweapi.com"
API_KEY = "YOUR_API_KEY"

resp = requests.post(
    f"{BASE_URL}/v1/images/generations",
    headers={
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json",
    },
    json={
        "model": "gpt-image-2",
        "prompt": "一只赛博朋克风格的猫",
        "size": "16:9",
        "quality": "standard",
        "response_format": "url",
    },
    timeout=600,
)

result = resp.json()
print(result["data"][0]["url"])

更多资源