Gemini Files API - 上传文件

POST

/upload/v1beta/files

Gemini Files API - 上传媒体文件，返回 fileUri 供后续识别接口使用（文件保留 48 小时）

Request

Query Params

Header Params

Body Params multipart/form-data

Responses

🟢200

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location -g --request POST 'https://newapi.mexxxxai.win/upload/v1beta/files?key={{GEMINI_API_KEY}}' \
--header 'X-Goog-Upload-Protocol: multipart' \
--header 'X-Goog-Upload-Command: start, upload, finalize' \
--form 'metadata="{\"file\": {\"displayName\": \"my-media-file\"}}";type=application/json' \
--form 'file=@""'

Response Example

{
  "file": {
    "name": "files/abc123xyz",
    "displayName": "my-media-file",
    "mimeType": "image/jpeg",
    "sizeBytes": "204800",
    "createTime": "2026-04-02T08:00:00.000Z",
    "updateTime": "2026-04-02T08:00:00.000Z",
    "expirationTime": "2026-04-04T08:00:00.000Z",
    "sha256Hash": "YWJjZGVmMTIzNDU2Nzg5MA==",
    "uri": "https://generativelanguage.googleapis.com/v1beta/files/abc123xyz",
    "state": "ACTIVE"
  }
}

Modified at 2026-04-02 11:32:32

Gemini - 音频理解

Messages - 基础文本对话