> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jimmyai.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# SP Query Real-Person Status

> 查询单个 Seedance SP 真人加白素材的处理状态。

Query whitelist processing status for a Seedance SP real-person asset.

## Request body

| Field      | Type   | Required | Description                                                                                     |
| ---------- | ------ | -------- | ----------------------------------------------------------------------------------------------- |
| `asset_id` | string | Yes      | `asset_id` from [Submit Real-Person Whitelist](/en/api-reference/seedance/sp/realperson-submit) |

## Example

```bash theme={null}
curl -X POST 'https://www.jimmyai.cn/api/open-api/v1/seedance/sp/realperson/status' \
  -H 'Authorization: Bearer sk_xxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "asset_id": "official_id_xxx"
  }'
```

## Response fields

| Field       | Description                                         |
| ----------- | --------------------------------------------------- |
| `asset_id`  | Asset ID                                            |
| `status`    | `Processing` / `Active` / `Failed`                  |
| `asset_ref` | Reference for video create; available when `Active` |
| `name`      | Asset name                                          |
| `url`       | Asset URL                                           |

## Status values

| Status       | Meaning                    |
| ------------ | -------------------------- |
| `Processing` | Keep polling               |
| `Active`     | Ready for video generation |
| `Failed`     | Processing failed          |

## Batch query

To query multiple real-person assets at once:

`POST /api/open-api/v1/seedance/sp/realperson/batch-status`

Body: `{ "asset_ids": ["id1", "id2"] }`. Returns an `items` array with the same shape as the single-query response.


## OpenAPI

````yaml POST /api/open-api/v1/seedance/sp/realperson/status
openapi: 3.1.0
info:
  title: Jimmy AI OpenAPI
  description: API for Jimmy AI video generation services
  version: 1.0.0
servers:
  - url: https://www.jimmyai.cn
    description: Production server
security:
  - bearerAuth: []
paths:
  /api/open-api/v1/seedance/sp/realperson/status:
    post:
      summary: SP Query Real-Person Status
      description: >-
        Query whitelist processing status for a single Seedance SP real-person
        asset.
      operationId: querySeedanceSpRealPersonStatus
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SeedanceSpRealPersonStatusRequest'
      responses:
        '200':
          description: Queried successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SeedanceSpRealPersonResponse'
components:
  schemas:
    SeedanceSpRealPersonStatusRequest:
      type: object
      required:
        - asset_id
      properties:
        asset_id:
          type: string
          description: asset_id returned from whitelist submit
    SeedanceSpRealPersonResponse:
      type: object
      properties:
        code:
          type: integer
          example: 0
        msg:
          type: string
          example: ok
        data:
          type: object
          properties:
            asset_id:
              type: string
            official_id:
              type: string
            status:
              type: string
              description: Processing / Active / Failed
            asset_ref:
              type: string
              description: Reference usable in video create requests
            name:
              type: string
            url:
              type: string
            created_at:
              type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````