Получить ресурс

Получение состояния обработки ресурса, временного адреса доступа и ошибок.

После загрузки получайте состояние ресурса с интервалом около 3 секунд. Processing — обработка продолжается, Active — ресурс доступен для генерации, Failed — обработка завершилась ошибкой и следует прочитать Result.Error.

Result.URL — подписанный адрес со сроком действия около 11,5 часа; не сохраняйте его как постоянный и не распространяйте публично. Ресурс привязан к аккаунту текущего ключа API; при отсутствии ресурса или прав доступа может возвращаться ResourceNotFound.

POST/v1/assets/doubao/

Получайте состояние ресурса. При Processing продолжайте опрос, при Active ресурс доступен для использования, при Failed прочитайте Result.Error.

Аутентификация

bearerAuth

АутентификацияBearer <token>

Расположение: header

Параметры строки запроса

Action*"GetAsset"

Всегда GetAsset.

По умолчанию"GetAsset"

Допустимые значения

"GetAsset"

Version*"2024-01-01"

Версия API, всегда 2024-01-01.

По умолчанию"2024-01-01"

Допустимые значения

"2024-01-01"

Тело запроса

application/json

Определения типов TypeScript

Используйте тип request body в TypeScript.

Id*string

ID ресурса с префиксом asset-.

ProjectName?string

Управляется централизованно платформой; переданное значение не используется для разделения бизнес-данных.

Тело ответа

`application/json`

curl -X POST "https://example.com/v1/assets/doubao/?Action=GetAsset&Version=2024-01-01" \  -H "Content-Type: application/json" \  -d '{    "Id": "asset-20260807163106-krnhc"  }'

{
  "ResponseMetadata": {
    "RequestId": "20260807163109F1A2",
    "Action": "GetAsset",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "xx-xxxxxx"
  },
  "Result": {
    "Id": "asset-20260807163106-krnhc",
    "Name": "Изображение персонажа",
    "URL": "https://example.com/signed-asset?X-Tos-Expires=41400",
    "AssetType": "Image",
    "GroupId": "group-20260807163049-f9mfw",
    "Status": "Active",
    "Moderation": {
      "Strategy": "Default"
    },
    "CreateTime": "2026-08-07T08:31:06Z",
    "UpdateTime": "2026-08-07T08:31:09Z"
  }
}

Аутентификация

Параметры строки запроса

Тело запроса

Тело ответа

200application/json

400

401

404application/json

503

5XX

`application/json`

`application/json`