Alibaba Cloud Model Studio:API manajemen tugas asinkron

Header

Authorization

String

Ya

Kunci API dalam format Bearer sk-xxx

Bearer sk-xxx

Path

task_id

String

Ya

ID tugas yang akan dikueri.

a8532587-xxxx-xxxx-xxxx-0c46b17950d1

request_id

String

ID unik untuk permintaan ini.

7574ee8f-xxxx-xxxx-xxxx-11c33ab46e51

output

Object

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

• Jika tugas gagal atau sebagian gagal, output mengembalikan bidang code dan message yang menjelaskan alasan kegagalan.

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

-

output.task_id

String

ID tugas yang dikueri.

a8532587-xxxx-xxxx-xxxx-0c46b17950d1

output.task_status

String

Status tugas.

• Untuk tugas multi-subtugas, tugas dianggap berhasil jika minimal satu subtugas berhasil.

• Subtugas yang gagal menampilkan kesalahan spesifik di output.

Status tugas:

• PENDING

• RUNNING

• SUCCEEDED

• FAILED

• UNKNOWN

output.submit_time

String

Waktu tugas diajukan.

2023-12-20 21:36:31.896

output.scheduled_time

String

Waktu tugas dijadwalkan (saat mulai berjalan).

2023-12-20 21:36:39.009

output.end_time

String

Waktu tugas berakhir.

2023-12-20 21:36:45.913

output.code

String

Kode kesalahan (hanya dikembalikan jika tugas gagal).

-

output.message

String

Pesan kesalahan (hanya dikembalikan jika tugas gagal).

-

output.task_metrics

Object

Metrik tugas termasuk statistik status subtugas.

{

"TOTAL": 4, // Total jumlah subtugas

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

"FAILED": 1 // Jumlah subtugas yang gagal

}

usage

Object

Informasi penagihan untuk permintaan ini (berbeda-beda tergantung tugas).

"usage": {"image_count": 1}

Header

Authorization

String

Ya

Kunci API, dalam format Bearer sk-xxx.

Bearer sk-xxx

Params

task_id

String

Tidak

ID tugas yang akan dikueri. Tentukan task_id untuk hanya mengembalikan status tugas tersebut, atau kosongkan untuk mengkueri beberapa tugas.

a8532587-xxxx-xxxx-xxxx-0c46b17950d1

start_time

String

Tidak

Waktu mulai kueri dalam format YYYYMMDDhhmmss. Nilai default: 24 jam sebelum end_time (jika end_time ditentukan), atau 24 jam terakhir (jika tidak ada waktu yang ditentukan). Rentang maksimum: 24 jam.

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

end_time

String

Tidak

Waktu akhir kueri dalam format YYYYMMDDhhmmss. Nilai default: 24 jam setelah start_time (jika start_time ditentukan). Rentang maksimum: 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 dikembalikan. Default: 1.

-

page_size

Integer

Tidak

Jumlah entri per halaman. Default: 10.

-

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 (milidetik sejak epoch).

data[].start_time

Long

Waktu tugas dimulai, dalam milidetik sejak epoch.

data[].end_time

Long

Waktu tugas berakhir, 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 API unik yang dihasilkan dari parameter API model saat tugas diajukan.

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": "Requests rate limit exceeded, please try again later."

Header

Authorization

String

Ya

Kunci API, dalam format Bearer sk-xxx.

Bearer sk-xxx

Path

task_id

String

Ya

ID tugas yang akan dibatalkan.

a8532587-xxxx-xxxx-xxxx-0c46b17950d1

code

String

Kode kesalahan yang dikembalikan ketika pemanggilan gagal.

"code": "Throttling.RateQuota"

message

String

Pesan kesalahan yang dikembalikan ketika pemanggilan gagal.

"message": "Requests rate limit exceeded, please try again later."

400

UnsupportedOperation

Failed to cancel the task. Confirm that the task is in PENDING status.

Pembatalan tugas gagal. Hanya tugas dalam status PENDING yang dapat dibatalkan.