API Gemini hỗ trợ tải các tệp nội dung nghe nhìn lên riêng biệt với dữ liệu đầu vào của câu lệnh, cho phép bạn sử dụng lại nội dung nghe nhìn trên nhiều yêu cầu và nhiều câu lệnh. Để biết thêm thông tin chi tiết, hãy xem hướng dẫn Gợi ý bằng nội dung nghe nhìn.
Phương thức: media.upload
Tạo File
.
Điểm cuối
- URI tải lên, dành cho các yêu cầu tải nội dung nghe nhìn lên:
https: / /generativelanguage.googleapis.com /upload /v1beta /files
- URI siêu dữ liệu, dành cho các yêu cầu chỉ siêu dữ liệu:
https: / /generativelanguage.googleapis.com /v1beta /files
URL sử dụng cú pháp Chuyển mã gRPC.
Nội dung yêu cầu
Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:
file
object (File
)
Không bắt buộc. Siêu dữ liệu cho tệp cần tạo.
Yêu cầu mẫu
Hình ảnh
Python
Node.js
Go
Vỏ
Âm thanh
Python
Node.js
Go
Vỏ
Văn bản
Python
Node.js
Go
Vỏ
Video
Python
Node.js
Go
Vỏ
Python
Phương thức: files.get
Lấy siêu dữ liệu cho File
đã cho.
Điểm cuối
gethttps: / /generativelanguage.googleapis.com /v1beta /{name=files /*}
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
name
string
Bắt buộc. Tên của File
cần lấy. Ví dụ: files/abc-123
Nó có dạng files/{file}
.
Nội dung yêu cầu
Nội dung yêu cầu phải trống.
Yêu cầu mẫu
Python
Node.js
Go
Vỏ
Nội dung phản hồi
Nếu thành công, nội dung phản hồi sẽ chứa một phiên bản của File
.
Phương thức: files.list
Liệt kê siêu dữ liệu cho File
do dự án yêu cầu sở hữu.
Điểm cuối
gethttps: / /generativelanguage.googleapis.com /v1beta /files
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số truy vấn
pageSize
integer
Không bắt buộc. Số lượng File
tối đa cần trả về trên mỗi trang. Nếu không được chỉ định, giá trị mặc định là 10. pageSize
tối đa là 100.
pageToken
string
Không bắt buộc. Mã thông báo trang từ lệnh gọi files.list
trước đó.
Nội dung yêu cầu
Nội dung yêu cầu phải trống.
Yêu cầu mẫu
Python
Node.js
Go
Vỏ
Nội dung phản hồi
Phản hồi cho files.list
.
Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:
files[]
object (File
)
Danh sách File
.
nextPageToken
string
Mã thông báo có thể được gửi dưới dạng pageToken
vào lệnh gọi files.list
tiếp theo.
Biểu diễn dưới dạng JSON |
---|
{
"files": [
{
object ( |
Phương thức: files.delete
Xoá File
.
Điểm cuối
xoáhttps: / /generativelanguage.googleapis.com /v1beta /{name=files /*}
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
name
string
Bắt buộc. Tên của File
cần xoá. Ví dụ: files/abc-123
Nó có dạng files/{file}
.
Nội dung yêu cầu
Nội dung yêu cầu phải trống.
Yêu cầu mẫu
Python
Node.js
Go
Vỏ
Nội dung phản hồi
Nếu thành công, nội dung phản hồi sẽ là một đối tượng JSON trống.
Tài nguyên REST: tệp
Tài nguyên: Tệp
Tệp được tải lên API. Mã nhận dạng tiếp theo: 15
name
string
Không thể thay đổi. Giá trị nhận dạng. Tên tài nguyên File
. Mã nhận dạng (tên không bao gồm tiền tố "files/") có thể chứa tối đa 40 ký tự chữ-số viết thường hoặc dấu gạch ngang (-). Mã nhận dạng không được bắt đầu hoặc kết thúc bằng dấu gạch ngang. Nếu bạn để trống tên khi tạo, hệ thống sẽ tạo một tên duy nhất. Ví dụ: files/123-456
displayName
string
Không bắt buộc. Tên hiển thị mà con người đọc được cho File
. Tên hiển thị không được dài quá 512 ký tự, bao gồm cả dấu cách. Ví dụ: "Hình ảnh chào mừng"
mimeType
string
Chỉ có đầu ra. Loại MIME của tệp.
sizeBytes
string (int64 format)
Chỉ có đầu ra. Kích thước tệp tính bằng byte.
createTime
string (Timestamp
format)
Chỉ có đầu ra. Dấu thời gian của thời điểm tạo File
.
Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z"
, "2014-10-02T15:01:23.045123456Z"
hoặc "2014-10-02T15:01:23+05:30"
.
updateTime
string (Timestamp
format)
Chỉ có đầu ra. Dấu thời gian của lần cập nhật gần đây nhất của File
.
Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z"
, "2014-10-02T15:01:23.045123456Z"
hoặc "2014-10-02T15:01:23+05:30"
.
expirationTime
string (Timestamp
format)
Chỉ có đầu ra. Dấu thời gian cho biết thời điểm File
sẽ bị xoá. Chỉ đặt nếu File
được lên lịch hết hạn.
Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z"
, "2014-10-02T15:01:23.045123456Z"
hoặc "2014-10-02T15:01:23+05:30"
.
sha256Hash
string (bytes format)
Chỉ có đầu ra. Hàm băm SHA-256 của các byte đã tải lên.
Chuỗi được mã hoá base64.
uri
string
Chỉ có đầu ra. Uri của File
.
downloadUri
string
Chỉ có đầu ra. Uri tải xuống của File
.
state
enum (State
)
Chỉ có đầu ra. Trạng thái xử lý của Tệp.
source
enum (Source
)
Nguồn của tệp.
error
object (Status
)
Chỉ có đầu ra. Trạng thái lỗi nếu không xử lý được tệp.
metadata
Union type
metadata
chỉ có thể là một trong những giá trị sau:videoMetadata
object (VideoMetadata
)
Chỉ có đầu ra. Siêu dữ liệu của một video.
Biểu diễn dưới dạng JSON |
---|
{ "name": string, "displayName": string, "mimeType": string, "sizeBytes": string, "createTime": string, "updateTime": string, "expirationTime": string, "sha256Hash": string, "uri": string, "downloadUri": string, "state": enum ( |
VideoMetadata
Siêu dữ liệu của video File
.
videoDuration
string (Duration
format)
Thời lượng của video.
Thời lượng tính bằng giây, có tối đa 9 chữ số thập phân, kết thúc bằng "s
". Ví dụ: "3.5s"
.
Biểu diễn dưới dạng JSON |
---|
{ "videoDuration": string } |
Tiểu bang
Các trạng thái cho vòng đời của một Tệp.
Enum | |
---|---|
STATE_UNSPECIFIED |
Giá trị mặc định. Giá trị này được sử dụng nếu bạn bỏ qua trạng thái. |
PROCESSING |
Tệp đang được xử lý và chưa thể dùng để suy luận. |
ACTIVE |
Tệp đã được xử lý và có thể dùng để suy luận. |
FAILED |
Không xử lý được tệp. |
Nguồn
Enum | |
---|---|
SOURCE_UNSPECIFIED |
Được dùng nếu không chỉ định nguồn. |
UPLOADED |
Cho biết tệp do người dùng tải lên. |
GENERATED |
Cho biết tệp do Google tạo. |
Trạng thái
Loại Status
xác định một mô hình lỗi logic phù hợp với nhiều môi trường lập trình, bao gồm cả API REST và API RPC. gRPC sử dụng lớp này. Mỗi thông báo Status
chứa 3 phần dữ liệu: mã lỗi, thông báo lỗi và thông tin chi tiết về lỗi.
Bạn có thể tìm hiểu thêm về mô hình lỗi này và cách xử lý mô hình lỗi này trong Hướng dẫn thiết kế API.
code
integer
Mã trạng thái, phải là giá trị enum của google.rpc.Code
.
message
string
Thông báo lỗi dành cho nhà phát triển, phải bằng tiếng Anh. Mọi thông báo lỗi hiển thị với người dùng đều phải được bản địa hoá và gửi trong trường google.rpc.Status.details
hoặc do ứng dụng bản địa hoá.
details[]
object
Danh sách thông báo chứa thông tin chi tiết về lỗi. Có một bộ loại thông báo phổ biến để các API sử dụng.
Một đối tượng chứa các trường thuộc một loại tuỳ ý. Một trường bổ sung "@type"
chứa URI xác định loại. Ví dụ: { "id": 1234, "@type": "types.example.com/standard/id" }
.
Biểu diễn dưới dạng JSON |
---|
{ "code": integer, "message": string, "details": [ { "@type": string, field1: ..., ... } ] } |