Integracja i użycie API SeeDream Tasks

Główną funkcją API SeeDream Tasks jest umożliwienie zapytania o status wykonania zadania poprzez wprowadzenie ID zadania wygenerowanego przez API SeeDream Images Generation. Dokument ten szczegółowo opisuje instrukcje integracji API SeeDream Tasks, aby pomóc Ci łatwo zintegrować i w pełni wykorzystać potężne możliwości tego API. Dzięki API SeeDream Tasks możesz łatwo realizować zapytania o status wykonania zadań API SeeDream Images Generation.

Proces aplikacji

Aby korzystać z API SeeDream Images Generation, najpierw przejdź do konsoli Ace Data Cloud, aby uzyskać swój token API, który należy zachować na przyszłość.

Jeśli nie jesteś zalogowany lub zarejestrowany, automatycznie zostaniesz przekierowany na stronę logowania, aby zarejestrować się i zalogować, a po zakończeniu zostaniesz automatycznie przekierowany z powrotem na bieżącą stronę. Jeden token API wystarczy do wywołania wszystkich usług platformy, nie ma potrzeby składania osobnych wniosków dla każdej usługi. Przy pierwszym wniosku przyznawana jest darmowa kwota, aby móc skorzystać z doświadczenia; w przypadku niewystarczającej kwoty można doładować saldo ogólne w konsoli.

📘 Pełna dokumentacja: API SeeDream Images Generation →

Przykład zapytania

API SeeDream Tasks można wykorzystać do zapytania o wyniki API SeeDream Images Generation. Aby dowiedzieć się, jak korzystać z API SeeDream Images Generation, zapoznaj się z dokumentacją API SeeDream Images Generation. Posłużymy się przykładem ID zadania zwróconego przez usługę API SeeDream Images Generation. Załóżmy, że mamy ID zadania: 20068983-0cc9-4c6a-aeb6-9c6a3c668be0, a następnie pokażemy, jak to zrobić, przekazując ID zadania.

Przykład zadania

Ustawienia nagłówków żądania i ciała żądania

Nagłówki żądania obejmują:

accept: określa, że oczekiwany jest wynik odpowiedzi w formacie JSON, tutaj wpisz application/json.
authorization: klucz do wywołania API, po złożeniu wniosku można go bezpośrednio wybrać z rozwijanej listy.

Ciało żądania obejmuje:

id: przesłane ID zadania.
action: sposób operacji na zadaniu.

Ustawienia przedstawione na poniższym obrazku:

Przykład kodu

Można zauważyć, że po prawej stronie strony automatycznie wygenerowano kod w różnych językach, jak pokazano na obrazku:

Przykłady kodu są następujące:

CURL

curl -X POST 'https://api.acedata.cloud/seedream/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "id": "a6e0d456-189b-4c78-9232-2fe72166ab39",
  "action": "retrieve"
}'

Przykład odpowiedzi

Po pomyślnym złożeniu żądania API zwróci szczegółowe informacje o tym zadaniu. Na przykład:

{
  "success": true,
  "task_id": "84d1544a-9043-4dde-a98b-e889dacd75f6",
  "trace_id": "176acf03-7ca7-4fc6-85db-e3724d4f59eb",
  "data": [
    {
      "prompt": "a white siamese cat",
      "size": "2048x2048",
      "image_url": "https://platform.cdn.acedata.cloud/seedream/6e5f9085-cc4a-4801-b77b-31550129ff19.jpg"
    }
  ]
}

Zwracany wynik zawiera wiele pól, które są opisane poniżej:

success, status zadania generowania wideo w tym momencie.
task_id, ID zadania generowania wideo w tym momencie.
trace_id, ID śledzenia generowania wideo w tym momencie.
data, lista wyników zadania generowania obrazu w tym momencie.
- image_url, link do zadania generowania obrazu w tym momencie.
- prompt, słowo kluczowe.
- size: rozmiar wygenerowanego obrazu

Operacje zbiorcze

To jest zapytanie o szczegóły wielu ID zadań, w przeciwieństwie do powyższego, należy wybrać akcję jako retrieve_batch. Ciało żądania obejmuje:

ids: tablica przesłanych ID zadań.
action: sposób operacji na zadaniu.

Ustawienia przedstawione na poniższym obrazku:

Przykład kodu

Przykłady kodu są następujące:

Przykład odpowiedzi

Po pomyślnym złożeniu żądania API zwróci szczegółowe informacje o wszystkich zadaniach zbiorczych. Na przykład:

{
  "items": [
    {
      "_id": "69498b9bff2676299c5cb7a6",
      "id": "84d1544a-9043-4dde-a98b-e889dacd75f6",
      "api_id": "86ad30f3-0bc8-4b9b-b019-b9fa5b05672e",
      "application_id": "11e25072-de6d-4bd6-81e7-77ee0055499a",
      "created_at": 1766427547.107,
      "started_at": 1766427547.167,
      "finished_at": 1766427560.667,
      "elapsed": 13.5,
      "credential_id": "50892af9-597f-426e-a455-bc1739de95b0",
      "request": {
        "action": "generate",
        "model": "doubao-seedream-4-0-250828",
        "prompt": "biały kot syjamski"
      },
      "trace_id": "176acf03-7ca7-4fc6-85db-e3724d4f59eb",
      "type": "images",
      "user_id": "b60a9491-1eba-4ab8-a93f-12c0fd81dab4",
      "response": {
        "success": true,
        "task_id": "84d1544a-9043-4dde-a98b-e889dacd75f6",
        "trace_id": "176acf03-7ca7-4fc6-85db-e3724d4f59eb",
        "data": [
          {
            "prompt": "biały kot syjamski",
            "size": "2048x2048",
            "image_url": "https://platform.cdn.acedata.cloud/seedream/6e5f9085-cc4a-4801-b77b-31550129ff19.jpg"
          }
        ]
      }
    },
    {
      "_id": "69498b9bff2676299c5cb7a6",
      "id": "84d1544a-9043-4dde-a98b-e889dacd75f6",
      "api_id": "86ad30f3-0bc8-4b9b-b019-b9fa5b05672e",
      "application_id": "11e25072-de6d-4bd6-81e7-77ee0055499a",
      "created_at": 1766427547.107,
      "started_at": 1766427547.167,
      "finished_at": 1766427560.667,
      "elapsed": 13.5,
      "credential_id": "50892af9-597f-426e-a455-bc1739de95b0",
      "request": {
        "action": "generate",
        "model": "doubao-seedream-4-0-250828",
        "prompt": "biały kot syjamski"
      },
      "trace_id": "176acf03-7ca7-4fc6-85db-e3724d4f59eb",
      "type": "images",
      "user_id": "b60a9491-1eba-4ab8-a93f-12c0fd81dab4",
      "response": {
        "success": true,
        "task_id": "84d1544a-9043-4dde-a98b-e889dacd75f6",
        "trace_id": "176acf03-7ca7-4fc6-85db-e3724d4f59eb",
        "data": [
          {
            "prompt": "biały kot syjamski",
            "size": "2048x2048",
            "image_url": "https://platform.cdn.acedata.cloud/seedream/6e5f9085-cc4a-4801-b77b-31550129ff19.jpg"
          }
        ]
      }
    }
  ],
  "count": 2
}

返回结果一共有多个字段，其中items是包含了批量任务的具体详情信息，每个任务的具体信息与上文的字段一样，字段信息如下。

items，批量任务的所有具体详情信息. To jest tablica, każdy element tablicy ma taki sam format jak wynik zapytania pojedynczego zadania.
count，此处批量查询任务的个数.

批量结果里每个任务对象还带有以下计时字段.

created_at，任务创建时间，Unix 时间戳（秒，浮点）。
started_at，任务开始执行时间，Unix 时间戳（秒，浮点）。
finished_at，任务完成时间，Unix 时间戳（秒，浮点）。任务未完成时不返回该字段。
elapsed，任务执行耗时，单位为秒（浮点，保留 3 位小数）。任务未完成时不返回该字段。

CURL

curl -X POST 'https://api.acedata.cloud/seedance/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "ids": ["84d1544a-9043-4dde-a98b-e889dacd75f6","84d1544a-9043-4dde-a98b-e889dacd75f6"],
  "action": "retrieve_batch"
}'

错误处理

在调用 API 时，如果遇到错误，API 会返回相应的错误代码和信息。例如：

400 token_mismatched：Bad request, possibly due to missing or invalid parameters.
400 api_not_implemented：Bad request, possibly due to missing or invalid parameters.
401 invalid_token：Unauthorized, invalid or missing authorization token.
429 too_many_requests：Too many requests, you have exceeded the rate limit.
500 api_error：Internal server error, something went wrong on the server.

错误响应示例

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

结论

通过本文档，您已经了解了如何使用 SeeDream Tasks API 进行查询单个或批量任务的所有具体详情信息。希望本文档能帮助您更好地对接和使用该 API。如有任何问题，请随时联系我们的技术支持团队。

Getting Started

Czat AI

Obraz AI

Wideo AI

Audio AI

Sieć i dane

CAPTCHA

Tożsamość

Proxy

Advanced

Coding

Integracja i użycie API SeeDream Tasks

Proces aplikacji

Przykład zapytania

Przykład zadania

Ustawienia nagłówków żądania i ciała żądania

Przykład kodu

CURL

Przykład odpowiedzi

Operacje zbiorcze

Przykład kodu

Przykład odpowiedzi

CURL

错误处理

错误响应示例

结论

​Proces aplikacji

​Przykład zapytania

​Przykład zadania

​Ustawienia nagłówków żądania i ciała żądania

​Przykład kodu

​CURL

​Przykład odpowiedzi

​Operacje zbiorcze

​Przykład kodu

​Przykład odpowiedzi

​CURL

​错误处理

​错误响应示例

​结论

Proces aplikacji

Przykład zapytania

Przykład zadania

Ustawienia nagłówków żądania i ciała żądania

Przykład kodu

CURL

Przykład odpowiedzi

Operacje zbiorcze

Przykład kodu

Przykład odpowiedzi

CURL

错误处理

错误响应示例

结论