Skip to main content
POST
Upload Media
上传单个图片、GIF 或视频,返回一个 media_id,随后可在 post_twitter 里附加到推文。经 AIsa 网关代理,地址 https://api.aisa.one/apis/v1/twitter/upload_media。
本端点仅支持 multipart/form-data —— 请以表单部件上传文件。发送 JSON 请求体会返回 400 "upload_media requires multipart/form-data with a single media file field"。

前置条件

  • 一个 AIsa API Key(每次请求作为 Bearer 令牌)。
  • 源用户的一次性 OAuth 授权。通过 POST /apis/v1/twitter/auth_twitter 绑定你的 X 账号。
  • X 会话需持有 media.write、tweet.read、users.read。

两步媒体流程

  1. 上传 —— POST /apis/v1/twitter/upload_media 上传文件 → 返回 media_id。
  2. 发布 —— POST /apis/v1/twitter/post_twitter 传入 { "media": { "media_ids": ["<media_id>"] } }。
post_twitter 也支持在单次 multipart 请求里通过 media_files 内联文件,从而跳过预上传步骤。当你想把同一素材复用到多条推文,或把大文件上传与发推解耦时,使用 upload_media。

示例

响应
随后附加:

说明

  • 文件字段名可用 media_files、media 或 file。
  • ≤8MB 的图片走单次上传;更大文件与视频自动分片上传。
  • 未挂载的媒体约 24 小时后过期。
  • 媒体上传是前置步骤,不单独计费 —— 发推(post_twitter)时才计费。
更多见错误码与限流。

相关

发布推文

通过 media.media_ids 附加 media_id。

绑定 X 账号

启动本端点所需的 OAuth 流程。

点赞推文

使用同一 OAuth 会话的另一个写端点。

请求规范

  • 方法与路径: POST /apis/v1/twitter/upload_media
  • 可用状态: enabled
  • 请求 URL 模板: https://api.aisa.one/apis/v1/twitter/upload_media
  • Runtime 事实版本: 4629b96294875c448210d32f1a74b44ad7bab9721bd58b505e76c72a31741c73
完整 OpenAPI 定义 有效请求与价格声明(包括认证和引用的 schema):

费用与请求规则

公开参考价格:每次成功请求 $0.000001 USD。 最终费用以账户适用价格及实际结算为准。 公开参考值不是你的账户报价或最终扣费。对于支持 X-AISA-Cost-Mode: quote 的接口,执行前请针对完整请求获取免费报价;执行后通过响应费用元数据和 Usage Logs 核对结算费用。1 USD 等于 1,000,000 个整数 micro-USD。
  • 默认请求参考估价(USD): 1e-06
  • 计费依据: explicit_zero
  • 结算证据来源: request_snapshot

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

multipart/form-data
media_files
file
必填

The media file to upload (image/*, image/gif, or video/*). The field may also be named media or file. Images up to 8 MB use a single-shot upload; larger files and video use chunked upload automatically.

aisa_api_key
string

Optional. Normally unnecessary — the gateway resolves your account from the Authorization: Bearer header.

响应

Upload succeeded; returns the media_id to reference in post_twitter.

data
object