Alibaba Cloud Model Studio:Manajemen Tugas Asinkron API

Pengoperan Parameter

Bidang

Tipe

Diperlukan

Deskripsi

Contoh

Header

Authorization

String

Ya

Kunci API. Contoh: Bearer sk-xxx

Bearer sk-xxx

Path

task_id

String

Ya

ID tugas yang akan ditanyakan.

a8532587-xxxx-xxxx-xxxx-0c46b17950d1

Bidang

Tipe

Deskripsi

Contoh

request_id

String

ID unik untuk permintaan ini.

7574ee8f-xxxx-xxxx-xxxx-11c33ab46e51

output

Objek

• Jika tugas berhasil, output berisi objek hasil yang dihasilkan oleh model. Isi bervariasi tergantung pada jenis tugas.

• Jika tugas gagal atau sebagian gagal, output mengembalikan kode dan pesan yang menjelaskan alasan kegagalan.

• Untuk tugas yang mencakup beberapa subtugas, output mungkin berisi hasil subtugas yang berhasil serta pesan kesalahan untuk subtugas yang gagal.

-

output.task_id

String

ID tugas yang ditanyakan.

a8532587-xxxx-xxxx-xxxx-0c46b17950d1

output.task_status

String

Status tugas.

• Untuk tugas dengan beberapa subtugas, seluruh tugas ditandai berhasil jika setidaknya satu subtugas berhasil.

• Untuk subtugas yang gagal, kesalahan spesifik ditampilkan di output.

Status tugas:

• PENDING

• RUNNING

• SUCCEEDED

• FAILED

• UNKNOWN

output.submit_time

String

Waktu pengiriman tugas.

2023-12-20 21:36:31.896

output.scheduled_time

String

Waktu penjadwalan tugas, yaitu ketika mulai berjalan.

2023-12-20 21:36:39.009

output.end_time

String

Waktu berakhirnya tugas.

2023-12-20 21:36:45.913

output.code

String

Kode kesalahan. Ini hanya dikembalikan ketika tugas gagal.

-

output.message

String

Pesan kesalahan. Ini hanya dikembalikan ketika tugas gagal.

-

output.task_metrics

Objek

Metrik tugas, yang mencakup statistik tentang status subtugas.

{

"TOTAL": 4, // Total jumlah subtugas

"SUCCEEDED": 3, // Jumlah subtugas yang berhasil

"FAILED": 1 // Jumlah subtugas yang gagal

}

usage

Objek

Informasi penagihan untuk permintaan ini. Informasi penagihan bervariasi tergantung pada tugas.

"usage": {"image_count": 1}

Pengoperan parameter

Bidang

Tipe

Diperlukan

Deskripsi

Contoh

Header

Authorization

String

Ya

Kunci API. Contoh: Bearer sk-xxx

Bearer sk-xxx

Params

task_id

String

Tidak

ID tugas yang akan ditanyakan.

Jika Anda menentukan task_id, API hanya mengembalikan status tugas tersebut. Untuk menanyakan beberapa tugas, jangan gunakan parameter ini.

a8532587-xxxx-xxxx-xxxx-0c46b17950d1

start_time

String

Tidak

Waktu mulai rentang kueri. Formatnya adalah YYYYMMDDhhmmss.

• Jika Anda tidak menentukan waktu mulai, sistem akan menanyakan data dari 24 jam sebelum waktu akhir yang ditentukan.

• Jika Anda tidak menentukan waktu mulai atau akhir, sistem akan menanyakan data dari 24 jam terakhir secara default.

• Rentang waktu antara waktu mulai dan akhir tidak boleh lebih dari 24 jam.

20230420193058 merepresentasikan 19:30:58 pada tanggal 20 April 2023.

end_time

String

Tidak

Waktu akhir rentang kueri. Formatnya adalah YYYYMMDDhhmmss.

• Jika Anda tidak menentukan waktu akhir, sistem akan menanyakan data dari 24 jam setelah waktu mulai yang ditentukan.

• Rentang waktu antara waktu mulai dan akhir tidak boleh lebih dari 24 jam.

model_name

String

Tidak

Nama model.

wanx-v1

status

String

Tidak

Status tugas:

• PENDING

• RUNNING

• SUCCEEDED

• FAILED

• CANCELED

• UNKNOWN

page_no

Integer

Tidak

Nomor halaman hasil yang akan dikembalikan. Default: 1.

-

page_size

Integer

Tidak

Jumlah entri yang akan dikembalikan di setiap halaman. Default: 10.

-

Bidang

Tipe

Deskripsi

Contoh

request_id

String

ID unik untuk permintaan ini.

7574ee8f-xxxx-xxxx-xxxx-11c33ab46e51

data

Array

Daftar hasil kueri.

"data": [
    {
        "api_key_id": "235",
        "caller_uid": "1808342417264262",
        "end_time": 1682527200093,
        "gmt_create": 1682514589152,
        "model_name": "paraformer-16k-1",
        "region": "cn-hangzhou",
        "request_id": "32b67b58-xxxx-xxxx-xxxx-230f0aee64d9",
        "start_time": 1682515862179,
        "status": "FAILED",
        "task_id": "cf52b16b-xxxx-xxxx-xxxx-17f9c211440c",
        "user_api_unique_key": "apikey:v1:audio:asr:transcription:paraformer-16k-1"
    }
]

data[].api_key_id

String

ID Kunci API.

data[].caller_parent_id

String

ID Akun Alibaba Cloud.

data[].caller_uid

String

ID Akun Alibaba Cloud.

data[].gmt_create

Long

Waktu pembuatan tugas, dalam milidetik sejak epoch.

data[].start_time

Long

Waktu mulai tugas, dalam milidetik sejak epoch.

data[].end_time

Long

Waktu berakhirnya tugas, dalam milidetik sejak epoch.

data[].region

String

Wilayah. Contoh: cn-hangzhou

data[].request_id

String

ID permintaan untuk pengiriman tugas.

data[].status

String

Status tugas:

• PENDING

• RUNNING

• SUCCEEDED

• FAILED

• CANCELED

• UNKNOWN

data[].task_id

String

ID Tugas.

data[].user_api_unique_key

String

Kunci unik untuk API, yang merupakan indeks unik yang dibuat dari parameter API model ketika tugas dikirimkan.

data[].model_name

String

Nama model.

page_no

Integer

Nomor halaman saat ini.

"page_no": 1

page_size

Integer

Jumlah entri per halaman.

"page_size": 10

total_page

Integer

Total jumlah halaman.

"total_page": 4

total

Integer

Total jumlah entri.

"total": 39

code

String

Kode kesalahan yang dikembalikan ketika pemanggilan gagal.

"code": "Throttling.RateQuota"

message

String

Pesan kesalahan yang dikembalikan ketika pemanggilan gagal.

"message": "Batas laju permintaan terlampaui, silakan coba lagi nanti."

Pengoperan Parameter

Bidang

Tipe

Diperlukan

Deskripsi

Contoh

Header

Authorization

String

Ya

Kunci API. Contoh: Bearer sk-xxx

Bearer sk-xxx

Path

task_id

String

Ya

ID tugas yang akan dibatalkan.

a8532587-xxxx-xxxx-xxxx-0c46b17950d1

Bidang

Tipe

Deskripsi

Contoh

request_id

String

ID unik untuk permintaan ini.

7574ee8f-xxxx-xxxx-xxxx-11c33ab46e51

code

String

Kode kesalahan yang dikembalikan ketika pemanggilan gagal.

"code": "Throttling.RateQuota"

message

String

Pesan kesalahan yang dikembalikan ketika pemanggilan gagal.

"message": "Batas laju permintaan terlampaui, silakan coba lagi nanti."