Antarmuka file OpenAI - Alibaba Cloud Model Studio

Antarmuka unggah file digunakan untuk mengunggah file guna tanya jawab dokumen dan ekstraksi data dengan model Qwen-Long dan Qwen-Doc-Turbo. Anda juga dapat menggunakannya untuk mengunggah file input untuk tugas batch.

Penggunaan

Anda dapat memanggil antarmuka file menggunakan SDK OpenAI dalam Python atau Java, atau dengan melakukan panggilan API HTTP. Operasi yang didukung mencakup pengunggahan, kueri, dan penghapusan file.

Prasyarat

Kunci API Alibaba Cloud Model Studio: Buat kunci API dan Ekspor kunci API sebagai variabel lingkungan.
Untuk menggunakan SDK OpenAI, instal SDK OpenAI.

Ketersediaan model

Anda dapat menggunakan ID file dalam skenario berikut:

Qwen-Long: Melakukan tanya jawab pada dokumen panjang.
Qwen-Doc-Turbo: Mengekstraksi data dan melakukan tanya jawab pada file.
Pemrosesan batch: Mengunggah file batch.

Mulai

Unggah file

Ruang penyimpanan Model Studio mendukung maksimal 10.000 file dengan ukuran total hingga 100 GB. File-file tersebut tidak kedaluwarsa.

Untuk analisis dokumen

Tetapkan `purpose` ke file-extract. Format file yang didukung meliputi file teks (seperti TXT, DOCX, PDF, XLSX, EPUB, MOBI, MD, CSV, dan JSON) serta file citra (seperti BMP, PNG, JPG/JPEG, GIF, dan PDF hasil pemindaian). Ukuran maksimum untuk satu file adalah 150 MB.

Untuk informasi lebih lanjut tentang analisis dokumen menggunakan file_id, lihat konteks panjang (Qwen-Long).

Contoh permintaan

Python

import os
from pathlib import Path
from openai import OpenAI

client = OpenAI(
    # Jika Anda belum mengonfigurasi variabel lingkungan, ganti baris berikut dengan api_key="sk-xxx" dan gunakan Kunci API Model Studio Anda.
    # Kunci API untuk wilayah Singapura dan Tiongkok (Beijing) berbeda. Dapatkan kunci API: https://www.alibabacloud.com/help/en/model-studio/get-api-key
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    # Berikut ini adalah URL untuk wilayah Singapura. Jika Anda menggunakan model di wilayah Tiongkok (Beijing), ganti URL dengan: https://dashscope.aliyuncs.com/compatible-mode/v1
    base_url="https://dashscope-intl.aliyuncs.com/compatible-mode/v1",
)

# test.txt adalah file contoh lokal.
file_object = client.files.create(file=Path("test.txt"), purpose="file-extract")

print(file_object.model_dump_json())

Java

import com.openai.client.OpenAIClient;
import com.openai.client.okhttp.OpenAIOkHttpClient;
import com.openai.models.FileCreateParams;
import com.openai.models.FileObject;
import com.openai.models.FilePurpose;

import java.nio.file.Path;
import java.nio.file.Paths;

public class Main {
    public static void main(String[] args) {
        // Buat klien dan gunakan kunci API dari variabel lingkungan.
        OpenAIClient client = OpenAIOkHttpClient.builder()
                // Kunci API untuk wilayah Singapura dan Tiongkok (Beijing) berbeda. Dapatkan kunci API: https://www.alibabacloud.com/help/en/model-studio/get-api-key
                .apiKey(System.getenv("DASHSCOPE_API_KEY"))
                // Berikut ini adalah URL untuk wilayah Singapura. Jika Anda menggunakan model di wilayah Tiongkok (Beijing), ganti URL dengan: https://dashscope.aliyuncs.com/compatible-mode/v1
                .baseUrl("https://dashscope-intl.aliyuncs.com/compatible-mode/v1")
                .build();
        // Tetapkan path file. Sesuaikan path dan nama file sesuai kebutuhan.
        Path filePath = Paths.get("src/main/java/org/example/test.txt");
        // Buat parameter unggah file.
        FileCreateParams params = FileCreateParams.builder()
                .file(filePath)
                .purpose(FilePurpose.of("file-extract"))
                .build();

        // Unggah file.
        FileObject fileObject = client.files().create(params);
        System.out.println(fileObject);
    }
}

curl

# ======= Penting =======
# Kunci API untuk wilayah Singapura dan Tiongkok (Beijing) berbeda. Dapatkan kunci API: https://www.alibabacloud.com/help/en/model-studio/get-api-key
# Berikut ini adalah URL untuk wilayah Singapura. Jika Anda menggunakan model di wilayah Tiongkok (Beijing), ganti URL dengan: https://dashscope.aliyuncs.com/compatible-mode/v1/files
# === Hapus komentar ini sebelum menjalankan ===

curl -X POST https://dashscope-intl.aliyuncs.com/compatible-mode/v1/files \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
--form 'file=@"test.txt"' \
--form 'purpose="file-extract"'

Contoh tanggapan

{
    "id": "file-fe-xxx",
    "bytes": 2055,
    "created_at": 1729065448,
    "filename": "test.txt",
    "object": "file",
    "purpose": "file-extract",
    "status": "processed",
    "status_details": null
}

Untuk pemrosesan batch

Jika Anda menetapkan `purpose` ke batch, file input harus berupa file JSONL dan memenuhi Persyaratan file batch. Ukuran maksimum untuk satu file dalam tugas batch adalah 500 MB.

Untuk informasi lebih lanjut tentang panggilan batch, lihat Kompatibel dengan OpenAI - Batch.

Contoh permintaan

Python

import os
from pathlib import Path
from openai import OpenAI


client = OpenAI(
    # Jika Anda belum mengonfigurasi variabel lingkungan, ganti baris berikut dengan api_key="sk-xxx" dan gunakan Kunci API Model Studio Anda.
    # Kunci API untuk wilayah Singapura dan Tiongkok (Beijing) berbeda. Dapatkan kunci API: https://www.alibabacloud.com/help/en/model-studio/get-api-key
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    # Berikut ini adalah URL untuk wilayah Singapura. Jika Anda menggunakan model di wilayah Tiongkok (Beijing), ganti URL dengan: https://dashscope.aliyuncs.com/compatible-mode/v1
    base_url="https://dashscope-intl.aliyuncs.com/compatible-mode/v1",
)

# test.jsonl adalah file contoh lokal.
file_object = client.files.create(file=Path("test.jsonl"), purpose="batch")

print(file_object.model_dump_json())

Java

import com.openai.client.OpenAIClient;
import com.openai.client.okhttp.OpenAIOkHttpClient;
import com.openai.models.FileCreateParams;
import com.openai.models.FileObject;
import com.openai.models.FilePurpose;

import java.nio.file.Path;
import java.nio.file.Paths;

public class Main {
    public static void main(String[] args) {
        // Buat klien dan gunakan kunci API dari variabel lingkungan.
        OpenAIClient client = OpenAIOkHttpClient.builder()
                // Kunci API untuk wilayah Singapura dan Tiongkok (Beijing) berbeda. Dapatkan kunci API: https://www.alibabacloud.com/help/en/model-studio/get-api-key
                .apiKey(System.getenv("DASHSCOPE_API_KEY"))
                // Berikut ini adalah URL untuk wilayah Singapura. Jika Anda menggunakan model di wilayah Tiongkok (Beijing), ganti URL dengan: https://dashscope.aliyuncs.com/compatible-mode/v1
                .baseUrl("https://dashscope-intl.aliyuncs.com/compatible-mode/v1")
                .build();
        // Tetapkan path file. Sesuaikan path dan nama file sesuai kebutuhan.
        Path filePath = Paths.get("src/main/java/org/example/test.txt");
        // Buat parameter unggah file.
        FileCreateParams params = FileCreateParams.builder()
                .file(filePath)
                .purpose(FilePurpose.of("batch"))
                .build();

        // Unggah file.
        FileObject fileObject = client.files().create(params);
        System.out.println(fileObject);
    }
}

curl

# ======= Penting =======
# Kunci API untuk wilayah Singapura dan Tiongkok (Beijing) berbeda. Dapatkan kunci API: https://www.alibabacloud.com/help/en/model-studio/get-api-key
# Berikut ini adalah URL untuk wilayah Singapura. Jika Anda menggunakan model di wilayah Tiongkok (Beijing), ganti URL dengan: https://dashscope.aliyuncs.com/compatible-mode/v1/files
# === Hapus komentar ini sebelum menjalankan ===

curl -X POST https://dashscope-intl.aliyuncs.com/compatible-mode/v1/files \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
--form 'file=@"test.jsonl"' \
--form 'purpose="batch"'

Contoh tanggapan

{
    "id": "file-batch-xxx",
    "bytes": 231,
    "created_at": 1729065815,
    "filename": "test.jsonl",
    "object": "file",
    "purpose": "batch",
    "status": "processed",
    "status_details": null
}

Kueri informasi file

Kueri informasi file dengan menentukan file_id dalam metode retrieve atau GET.

OpenAI Python SDK

Contoh permintaan

import os
from openai import OpenAI

client = OpenAI(
    # Kunci API untuk wilayah Singapura dan Tiongkok (Beijing) berbeda. Dapatkan kunci API: https://www.alibabacloud.com/help/en/model-studio/get-api-key
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    # Berikut ini adalah URL untuk wilayah Singapura. Jika Anda menggunakan model di wilayah Tiongkok (Beijing), ganti URL dengan: https://dashscope.aliyuncs.com/compatible-mode/v1
    base_url="https://dashscope-intl.aliyuncs.com/compatible-mode/v1",
)

file = client.files.retrieve(file_id="file-batch-xxx")

print(file.model_dump_json())

Contoh tanggapan

{
  "id": "file-batch-xxx",
  "bytes": 27,
  "created_at": 1722480306,
  "filename": "test.txt",
  "object": "file",
  "purpose": "batch",
  "status": "processed",
  "status_details": null
}

OpenAI Java SDK

import com.openai.client.OpenAIClient;
import com.openai.client.okhttp.OpenAIOkHttpClient;
import com.openai.models.FileObject;
import com.openai.models.FileRetrieveParams;

public class Main {
    public static void main(String[] args) {
        // Buat klien dan gunakan kunci API dari variabel lingkungan.
        OpenAIClient client = OpenAIOkHttpClient.builder()
                // Kunci API untuk wilayah Singapura dan Tiongkok (Beijing) berbeda. Dapatkan kunci API: https://www.alibabacloud.com/help/en/model-studio/get-api-key
                .apiKey(System.getenv("DASHSCOPE_API_KEY"))
                // Berikut ini adalah URL untuk wilayah Singapura. Jika Anda menggunakan model di wilayah Tiongkok (Beijing), ganti URL dengan: https://dashscope.aliyuncs.com/compatible-mode/v1
                .baseUrl("https://dashscope-intl.aliyuncs.com/compatible-mode/v1")
                .build();
        // Buat parameter kueri file. Ganti fileId sesuai kebutuhan.
        FileRetrieveParams params= FileRetrieveParams.builder()
                .fileId("file-batch-xxx")
                .build();
        //Kueri file.
        FileObject fileObject = client.files().retrieve(params);
        System.out.println(fileObject);
    }
}

HTTP

Endpoint

Wilayah Singapura: GET https://dashscope-intl.aliyuncs.com/compatible-mode/v1/files/{file_id}
Wilayah Tiongkok (Beijing): GET https://dashscope.aliyuncs.com/compatible-mode/v1/files/{file_id}

Contoh permintaan

# ======= Penting =======
# Kunci API untuk wilayah Singapura dan Tiongkok (Beijing) berbeda. Dapatkan kunci API: https://www.alibabacloud.com/help/en/model-studio/get-api-key
# Berikut ini adalah URL untuk wilayah Singapura. Jika Anda menggunakan model di wilayah Tiongkok (Beijing), ganti URL dengan: https://dashscope.aliyuncs.com/compatible-mode/v1/files/file-batch-xxx
# === Hapus komentar ini sebelum menjalankan ===
curl -X GET https://dashscope-intl.aliyuncs.com/compatible-mode/v1/files/file-batch-xxx \
-H "Authorization: Bearer $DASHSCOPE_API_KEY"

Jika Anda menggunakan model di wilayah Tiongkok (Beijing), Anda harus menggunakan KUNCI API dari wilayah Tiongkok (Beijing) dan mengganti URL dengan: https://dashscope.aliyuncs.com/compatible-mode/v1/files/file-batch-xxx

Contoh tanggapan

{
    "id": "file-batch-xxx",
    "object": "file",
    "bytes": 499719,
    "created_at": 1715935833,
    "filename": "test.txt",
    "purpose": "batch",
    "status": "processed"
}

Kueri daftar file

Mengembalikan informasi tentang semua file Anda, termasuk file yang diunggah melalui antarmuka unggah dan file hasil dari batch.

Catatan

Operasi ini mendukung lebih banyak parameter filter. Untuk informasi selengkapnya, lihat Deskripsi parameter.

OpenAI Python SDK

Contoh permintaan

import os
from openai import OpenAI

client = OpenAI(
    # Kunci API untuk wilayah Singapura dan Tiongkok (Beijing) berbeda. Dapatkan kunci API: https://www.alibabacloud.com/help/en/model-studio/get-api-key
    api_key=os.getenv("DASHSCOPE_API_KEY"),
     # Berikut ini adalah URL untuk wilayah Singapura. Jika Anda menggunakan model di wilayah Tiongkok (Beijing), ganti URL dengan: https://dashscope.aliyuncs.com/compatible-mode/v1
    base_url="https://dashscope-intl.aliyuncs.com/compatible-mode/v1",
)

file_stk = client.files.list(after="file-batch-xxx",limit=20)
print(file_stk.model_dump_json())

Contoh tanggapan

{
  "data": [
    {
      "id": "file-batch-xxx",
      "bytes": 27,
      "created_at": 1722480543,
      "filename": "test.txt",
      "object": "file",
      "purpose": "batch",
      "status": "processed",
      "status_details": null
    },
    {
      "id": "file-batch-yyy",
      "bytes": 431986,
      "created_at": 1718089390,
      "filename": "test.pdf",
      "object": "file",
      "purpose": "batch",
      "status": "processed",
      "status_details": null
    }
  ],
  "object": "list",
  "has_more": false
}

OpenAI Java SDK

import com.openai.client.OpenAIClient;
import com.openai.client.okhttp.OpenAIOkHttpClient;
import com.openai.models.FileListPage;
import com.openai.models.FileListParams;

public class Main {
    public static void main(String[] args) {
        // Buat klien dan gunakan kunci API dari variabel lingkungan.
        OpenAIClient client = OpenAIOkHttpClient.builder()
                // Kunci API untuk wilayah Singapura dan Tiongkok (Beijing) berbeda. Dapatkan kunci API: https://www.alibabacloud.com/help/en/model-studio/get-api-key
                .apiKey(System.getenv("DASHSCOPE_API_KEY"))
                // Berikut ini adalah URL untuk wilayah Singapura. Jika Anda menggunakan model di wilayah Tiongkok (Beijing), ganti URL dengan: https://dashscope.aliyuncs.com/compatible-mode/v1
                .baseUrl("https://dashscope-intl.aliyuncs.com/compatible-mode/v1")
                .build();
        // Buat parameter kueri daftar file.
        FileListParams params = FileListParams.builder()
                .after("file-batch-xxx")
                .limit(20)
                .build();
        //Kueri daftar file.
        FileListPage file_stk = client.files().list(params);
        System.out.println(file_stk);
    }
}

HTTP

Endpoint

Wilayah Singapura: GET https://dashscope-intl.aliyuncs.com/compatible-mode/v1/files
Wilayah Tiongkok (Beijing): GET https://dashscope.aliyuncs.com/compatible-mode/v1/files

Contoh permintaan

# ======= Penting =======
# Kunci API untuk wilayah Singapura dan Tiongkok (Beijing) berbeda. Dapatkan kunci API: https://www.alibabacloud.com/help/en/model-studio/get-api-key
# Berikut ini adalah URL untuk wilayah Singapura. Jika Anda menggunakan model di wilayah Tiongkok (Beijing), ganti URL dengan: https://dashscope.aliyuncs.com/compatible-mode/v1/files
# === Hapus komentar ini sebelum menjalankan ===
curl -X GET https://dashscope-intl.aliyuncs.com/compatible-mode/v1/files \
-H "Authorization: Bearer $DASHSCOPE_API_KEY"

Jika Anda menggunakan model di wilayah Tiongkok (Beijing), Anda harus menggunakan KUNCI API dari wilayah Tiongkok (Beijing) dan mengganti URL dengan: https://dashscope.aliyuncs.com/compatible-mode/v1/files

Contoh tanggapan

{
    "object": "list",
    "has_more": true,
    "data": [
        {
            "id": "file-batch-xxx",
            "object": "file",
            "bytes": 84889,
            "created_at": 1715569225,
            "filename": "example.txt",
            "purpose": "batch",
            "status": "processed"
        },
        {
            "id": "file-batch-yyy",
            "object": "file",
            "bytes": 722355,
            "created_at": 1715413868,
            "filename": "Agent_survey.pdf",
            "purpose": "batch",
            "status": "processed"
        }
    ]
}

Hapus file

Menghapus file dengan file_id tertentu. Anda dapat mengkueri informasi file menggunakan API Kueri daftar file.

OpenAI Python SDK

Contoh permintaan

import os
from openai import OpenAI

client = OpenAI(
    # Kunci API untuk wilayah Singapura dan Tiongkok (Beijing) berbeda. Dapatkan kunci API: https://www.alibabacloud.com/help/en/model-studio/get-api-key
    api_key=os.getenv("DASHSCOPE_API_KEY"),
    # Berikut ini adalah URL untuk wilayah Singapura. Jika Anda menggunakan model di wilayah Tiongkok (Beijing), ganti URL dengan: https://dashscope.aliyuncs.com/compatible-mode/v1
    base_url="https://dashscope-intl.aliyuncs.com/compatible-mode/v1",
)

file_object = client.files.delete("file-batch-xxx")
print(file_object.model_dump_json())

Contoh tanggapan

{
  "object": "file",
  "deleted": true,
  "id": "file-batch-xxx"
}

OpenAI Java SDK

import com.openai.client.OpenAIClient;
import com.openai.client.okhttp.OpenAIOkHttpClient;
import com.openai.models.FileDeleteParams;
import com.openai.models.FileListPage;
import com.openai.models.FileListParams;

public class Main {
    public static void main(String[] args) {
        OpenAIClient client = OpenAIOkHttpClient.builder()
                // Kunci API untuk wilayah Singapura dan Tiongkok (Beijing) berbeda. Dapatkan kunci API: https://www.alibabacloud.com/help/en/model-studio/get-api-key
                .apiKey(System.getenv("DASHSCOPE_API_KEY"))
                // Berikut ini adalah URL untuk wilayah Singapura. Jika Anda menggunakan model di wilayah Tiongkok (Beijing), ganti URL dengan: https://dashscope.aliyuncs.com/compatible-mode/v1
                .baseUrl("https://dashscope-intl.aliyuncs.com/compatible-mode/v1")
                .build();
        FileDeleteParams params = FileDeleteParams.builder()
                .fileId("file-batch-xxx")
                .build();

        System.out.println(client.files().delete(params));
    }
}

HTTP

Endpoint

Wilayah Singapura: DELETE https://dashscope-intl.aliyuncs.com/compatible-mode/v1/files/{file_id}
Wilayah Tiongkok (Beijing): https://dashscope.aliyuncs.com/compatible-mode/v1/files/{file_id}

Contoh permintaan

# ======= Penting =======
# Kunci API untuk wilayah Singapura dan Tiongkok (Beijing) berbeda. Dapatkan kunci API: https://www.alibabacloud.com/help/en/model-studio/get-api-key
# Berikut ini adalah URL untuk wilayah Singapura. Jika Anda menggunakan model di wilayah Tiongkok (Beijing), ganti URL dengan: https://dashscope.aliyuncs.com/compatible-mode/v1/files/file-batch-xxx
# === Hapus komentar ini sebelum menjalankan ===
curl -X  DELETE https://dashscope-intl.aliyuncs.com/compatible-mode/v1/files/file-batch-xxx \
-H "Authorization: Bearer $DASHSCOPE_API_KEY"

Jika Anda menggunakan model dari wilayah Tiongkok (Beijing), Anda harus menggunakan KUNCI API dari wilayah Tiongkok (Beijing) dan mengganti URL dengan: https://dashscope.aliyuncs.com/compatible-mode/v1/files/file-batch-xxx

Contoh tanggapan

{
  "object": "file",
  "deleted": true,
  "id": "file-batch-oLIon7bzfxELqJBTS5okwC4E"
}

Penagihan

Operasi unggah file, penyimpanan, dan kueri tidak dikenai biaya. Anda hanya dikenai biaya untuk token input dan output yang digunakan saat memanggil model.

Batas laju

Batas permintaan per detik (QPS) untuk antarmuka unggah file adalah 3. Batas QPS total untuk antarmuka kueri informasi file, kueri daftar file, dan hapus file adalah 10.

Persiapan produksi

Pembersihan berkala: Hapus secara berkala file yang tidak digunakan untuk menghindari mencapai batas 10.000 file.
Pemeriksaan status: Setelah mengunggah file, periksa statusnya. Pastikan status bernilai processed sebelum menggunakan file tersebut.
Pemeriksaan batas laju: Batas QPS untuk antarmuka unggah file adalah 3. Batas QPS total untuk antarmuka kueri informasi file, kueri daftar file, dan hapus file adalah 10.
Penanganan kesalahan: Terapkan mekanisme penanganan pengecualian yang komprehensif untuk kesalahan jaringan, kesalahan API, dan masalah lainnya.

FAQ

1. Apa yang harus saya lakukan jika status file tetap "processing" setelah diunggah?

Pemrosesan file memerlukan waktu, tetapi biasanya selesai dalam beberapa detik. Jika status tetap "processing" dalam waktu lama:

Periksa apakah format file didukung.
Periksa apakah ukuran file melebihi batas.
Gunakan API retrieve untuk mengkueri status secara berkala.

2. Apakah ID file dapat digunakan lintas akun berbeda?

Tidak, tidak bisa. ID file hanya berlaku dalam Akun Alibaba Cloud yang menghasilkannya dan tidak dapat dibagikan antar akun.

3. Apakah file yang diunggah disimpan secara permanen?

Ya, demikian. File yang diunggah disimpan secara permanen dalam Akun Alibaba Cloud Anda kecuali Anda menghapusnya. Bersihkan secara berkala file yang tidak diperlukan.

4. Apa saja kemungkinan penyebab kegagalan unggah file?

Kunci API tidak valid atau belum diekspor.
Format file tidak didukung.
Ukuran file melebihi batas (file-extract: 150 MB, batch: 500 MB).
Jumlah maksimum file (10.000) atau batas ukuran total (100 GB) telah tercapai.
Batas QPS untuk antarmuka unggah file telah terlampaui. Batasnya adalah 3 QPS.

5. Haruskah saya memilih file-extract atau batch untuk parameter purpose?

file-extract: Gunakan ini untuk skenario analisis dokumen dengan Qwen-Long atau Qwen-Doc-Turbo.
batch: Gunakan ini untuk tugas batch. File harus berupa file JSONL yang memenuhi persyaratan format.

Deskripsi parameter

Kategori	Parameter	Tipe	Wajib	Deskripsi	Contoh
Unggah file	file	File	Ya	File yang akan diunggah.	Path("test.txt")
Unggah file	purpose	String	Ya	Menentukan tujuan file yang diunggah. Nilai yang valid: `file-extract`: Untuk pemahaman dokumen dengan model qwen-long. `batch`: Untuk pekerjaan Kompatibel dengan OpenAI - Batch. File harus dalam format yang ditentukan dalam File batch.	"file-extract"
Kueri file	file_id	String	Ya	ID file yang akan dikueri.	"file-fe-xxx"
	after	String	Tidak	Kursor yang digunakan untuk paginasi dalam tugas Kueri daftar file. Nilai parameter `after` adalah `file_id` dari item terakhir pada halaman saat ini. Ini mengambil halaman data berikutnya. Sebagai contoh, jika kueri mengembalikan 20 catatan dan `file_id` terakhir adalah `file-batch-xxx`, tetapkan `after="file-batch-xxx"` dalam kueri berikutnya untuk mengambil halaman berikutnya dari daftar.	"file-fe-xxx"
	create_before	String	Tidak	Dalam tugas Kueri daftar file, stempel waktu dalam format string. Digunakan untuk memfilter dan mengembalikan ID file yang dibuat sebelum waktu yang ditentukan.	`"20250306123000"`, `"2025-11-12 10:10:10"`, `"2025-11-12"`, `"20251112"`
	create_after	String	Tidak	Dalam tugas Kueri daftar file, stempel waktu dalam format string. Digunakan untuk memfilter dan mengembalikan ID file yang dibuat setelah waktu yang ditentukan.	`"20250306123000"`, `"2025-11-12 10:10:10"`, `"2025-11-12"`, `"20251112"`
	purpose	String	Tidak	Dalam tugas Kueri daftar file, memfilter file berdasarkan tujuan. Hanya mengembalikan ID file yang sesuai dengan tujuan yang ditentukan (`file-extract` atau `batch`).	"batch"
	limit	Integer	Tidak	Jumlah file yang dikembalikan untuk setiap kueri dalam tugas Kueri daftar file, dengan rentang nilai 1 hingga 2.000 dan nilai default 2.000.	2000
Penghapusan file	file_id	String	Ya	ID file yang akan dihapus.	"file-fe-xxx"
Parameter respons
Parameter respons umum	id	String	\	Pengidentifikasi file. Dalam tugas Hapus file, ini adalah ID file yang berhasil dihapus.	"file-fe-xxx"
	bytes	Integer		Ukuran file dalam byte.	81067
	created_at	Integer		Stempel waktu UNIX dalam detik saat file dibuat.	1617981067
	filename	String		Nama file yang diunggah.	"text.txt"
	object	String		Tipe objek. Untuk tugas Kueri daftar file, nilainya selalu "list". Dalam tugas lain, nilainya selalu "file".	"file"
	purpose	String		Tujuan file. Nilai yang valid adalah `batch`, `file-extract`, dan `batch_output`.	"file-extract"
	status	String		Status saat ini dari file.	"processed"
Kueri daftar file	has_more	Boolean		Menunjukkan apakah ada halaman data berikutnya.	false
Kueri daftar file	data	Array		Daftar file yang dikembalikan. Format setiap elemen dalam daftar konsisten dengan parameter respons umum.	`[{ "id": "xxx", "bytes": 27, "created_at": 1722480543, "filename": "test.txt", "object": "file", "purpose": "batch", "status": "processed", "status_details": null }]`
Hapus file	deleted	Boolean		Menunjukkan apakah penghapusan berhasil. Nilai true menandakan keberhasilan.	true

Kode kesalahan

Jika panggilan gagal, lihat Pesan kesalahan untuk pemecahan masalah.