OpenSearch：Ekstraksi konten gambar

Platform AI Search Open mendukung pemanggilan layanan ekstraksi konten gambar melalui API. Anda dapat mengintegrasikan layanan ini ke dalam rantai pemrosesan bisnis Anda. Teks yang dihasilkan dapat digunakan untuk skenario penelitian pengambilan gambar dan percakapan.

Daftar layanan

• Informasi otentikasi diperoleh.

  Saat memanggil layanan Platform AI Search Open menggunakan API, Anda perlu mengotentikasi identitas pemanggil.

• Alamat akses layanan diperoleh.

  Anda dapat memanggil layanan melalui Internet atau virtual private cloud (VPC). Untuk informasi lebih lanjut, lihat Dapatkan Alamat Pendaftaran Layanan.

Buat tugas ekstraksi asinkron

Metode permintaan

POST

URL

{host}/v3/openapi/workspaces/{workspace_name}/image-analyze/{service_id}/async

• host: Alamat untuk memanggil layanan. Layanan API dapat dipanggil melalui jaringan publik dan VPC. Untuk informasi lebih lanjut, lihat Dokumen yang Diriujuk.

• workspace_name: Nama ruang kerja, seperti default.

• service_id: ID layanan bawaan, seperti ops-image-analyze-vlm-001.

Parameter permintaan

Parameter Header

Otentikasi API-KEY

Parameter Body

Parameter tanggapan

Contoh permintaan cURL

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <Your API key>" \
  "http://***-hangzhou.opensearch.aliyuncs.com/v3/openapi/workspaces/default/image-analyze/ops-image-analyze-vlm-001/async"
  --data '{
    "document": {
      "url": "https://img01.yzcdn.cn/****/2017/05/11/FoTMgBa0SvUaAeFruY7i7O_EUMhf.jpg%21middle.jpg",
      "file_type": "jpg"
    }
  }' \ 

Contoh tanggapan

Contoh tanggapan normal

{
	"request_id":"CD4E26F0-23FF-449C-83DC-20CC8FF1****",
        "latency":8.0,
        "http_code":200,
        "result":{
                  "task_id":"cd4e26f0-23ff-449c-83dc-20cc8ff1****"
        }
}

Contoh tanggapan abnormal

Jika terjadi kesalahan dalam permintaan akses, hasil keluaran akan menunjukkan alasan kesalahan melalui kode dan pesan.

{
      "request_id":"0CCAC03B-D83F-432F-B6BA-C3049576****",
      "latency":0.0,
      "code":"InvalidParameter",
      "http_code":400,
      "message":"document.content atau document.url diperlukan, dan keduanya tidak boleh ada secara bersamaan"
}

Dapatkan status tugas ekstraksi asinkron

Metode permintaan

GET

URL

{host}/v3/openapi/workspaces/{workspace_name}/image-analyze/{service_id}/async/task-status?task_id=${task_id}

• host: Alamat untuk memanggil layanan. Layanan API dapat dipanggil melalui jaringan publik dan VPC. Untuk informasi lebih lanjut, lihat Dokumen yang Dirujuk.

• workspace_name: Nama ruang kerja, misalnya, default.

• service_id: ID layanan bawaan, misalnya, ops-image-analyze-vlm-001.

• task_id: ID tugas yang dikembalikan dalam respons penguraian gambar, misalnya, cd4e26f0-23ff-449c-83dc-20cc8ff1****.

Parameter permintaan

Parameter Header

Otentikasi API-KEY

Parameter tanggapan

Contoh permintaan cURL

curl -X GET \
-H"Content-Type: application/json" \
-H "Authorization: Bearer <Your API key>" \
"http://***-hangzhou.opensearch.aliyuncs.com/v3/openapi/workspaces/default/image-analyze/ops-image-analyze-vlm-001/async/task-status?task_id=d9781786-20b8-4fb4-bbb5-38f82e69****" 
 

Contoh tanggapan

Contoh tanggapan normal

{
      "request_id":"3C09570D-12DB-46B4-BF0F-A100D79B****",
      "latency":3,0,
      "http_code":200,
      "result":{
           "status":"SUCCESS",
           "data":{
                "content":"Gambar menunjukkan blender merek WMF dikelilingi oleh berbagai buah dan sayuran. Di sebelah blender terdapat gelas yang diisi dengan jus merah, dengan sedotan dimasukkan. Berserakan di atas meja adalah beberapa irisan lemon, beberapa stroberi, dan beberapa kiwi. Di salah satu sudut meja, ada nanas potong dan jeruk. Selain itu, beberapa wortel dipotong menjadi potongan kecil dan ditempatkan di dalam blender, siap untuk dijus. Keseluruhan adegan terlihat sangat sehat dan lezat.",
                "content_type":"plain"
            },
            "task_id":"d9781786-20b8-4fb4-bbb5-38f82e69****"
       },
            "usage":{
                "token_count":95
            }
}

Contoh tanggapan abnormal

Jika terjadi kesalahan dalam permintaan akses, hasil keluaran akan menunjukkan alasan kesalahan melalui kode dan pesan.

{
  "request_id":"153FC253-468D-4C46-873E-2AEB918C****",
  "latency":2.0,
  "code":"BadRequest.TaskNotExist",
  "http_code":404,
  "message":"task[d9781786-20b8-4fb4-bbb5-38f82e690b****] not exist"
}

Buat tugas ekstraksi sinkron

Metode permintaan

POST

URL

{host}/v3/openapi/workspaces/{workspace_name}/image-analyze/{service_id}/sync

Deskripsi parameter

• host: Alamat untuk memanggil layanan. Layanan API dapat dipanggil melalui jaringan publik dan VPC. Untuk informasi lebih lanjut, lihat Dokumen yang Dirujuk.

• workspace_name: Nama ruang kerja, misalnya, default.

• service_id: ID layanan bawaan, misalnya, ops-image-analyze-vlm-001.

Parameter permintaan

Parameter Header

Otentikasi API-KEY

Parameter Body

Parameter tanggapan

Contoh permintaan cURL

curl -X POST \
-H"Content-Type: application/json" \
-H "Authorization: Bearer <Your API key>" \
 "http://***-hangzhou.opensearch.aliyuncs.com/v3/openapi/workspaces/default/image-analyze/ops-image-analyze-vlm-001/sync" \
\ -d "{    
      \"document\":{    
            \"url\":\"https://img01.yzcdn.cn/****/2017/05/11/FoTMgBa0SvUaAeFruY7i7O_EUMhf.jpg%21middle.jpg\",   
            \"file_type\":\"jpg\"
      }
}"

Contoh tanggapan

Contoh tanggapan normal

{
    "request_id":"BB5CD4C3-C8B6-40E7-A037-4ADAE88A****", 
    "latency":12525,0,
    "http_code":200,
    "result":{
        "status":"SUCCESS",
        "data":{
              "content":"Gambar menunjukkan blender merek WMF dikelilingi oleh berbagai buah dan sayuran. Di sebelah blender terdapat gelas yang diisi dengan jus merah, dengan sedotan dimasukkan. Berserakan di atas meja adalah beberapa irisan lemon, beberapa stroberi, dan beberapa kiwi. Di salah satu sudut meja, ada nanas potong dan jeruk. Selain itu, beberapa wortel dipotong menjadi potongan kecil dan ditempatkan di dalam blender, siap untuk dijus. Keseluruhan adegan terlihat sangat sehat dan lezat.",
              "content_type":"plain"
        }
      },
      "usage":{
          "token_count":95
      }
}

Contoh tanggapan abnormal

Jika terjadi kesalahan dalam permintaan akses, hasil keluaran akan menunjukkan alasan kesalahan melalui kode dan pesan.

{
    "request_id": "6F33AFB6-A35C-4DA7-AFD2-9EA16CCF****",
    "latency": 2.0,
    "code": "InvalidParameter",
    "http_code": 400,
    "message": "Kesalahan penguraian JSON: Tidak dapat mendeserialisasi nilai tipe `ImageStorage` dari String \\"xxx\\""
}

Deskripsi kode status

Untuk deskripsi kode status lebih lanjut, lihat Dokumen yang Dirujuk.