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

# Doubao Seed 2.0 Responses API - Quick Start

> - Use Responses API format to call Doubao Seed 2.0 series models
- Supports server-side context storage, enabling multi-turn conversations via `previous_response_id`
- Minimal parameters, quick start
- Supported models: `doubao-seed-2.0-pro`, `doubao-seed-2.0-lite`, `doubao-seed-2.0-mini`, `doubao-seed-2.0-code`
- Need more features? Check out [Complete API Reference](./doubao-seed-2.0-responses-reference)

<Note>
  **BaseURL**: The default BaseURL is `https://direct.evolink.ai`, which has better support for text models and long-lived connections. `https://api.evolink.ai` is the primary endpoint for multimodal services and serves as a fallback address for text models.
</Note>


## OpenAPI

````yaml /en/api-manual/language-series/doubao-seed-2.0/doubao-seed-2.0-responses-quickstart.json POST /v1/responses
openapi: 3.1.0
info:
  title: Doubao Seed 2.0 Responses API Quick Start
  description: Get started with Doubao Seed 2.0 Responses API in 5 minutes
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://direct.evolink.ai
    description: Production (recommended)
  - url: https://api.evolink.ai
    description: Alternative URL
security:
  - bearerAuth: []
tags:
  - name: Responses API
    description: Responses API chat generation interface
paths:
  /v1/responses:
    post:
      tags:
        - Responses API
      summary: Doubao Seed 2.0 Responses API Quick Chat
      description: >-
        - Use Responses API format to call Doubao Seed 2.0 series models

        - Supports server-side context storage, enabling multi-turn
        conversations via `previous_response_id`

        - Minimal parameters, quick start

        - Supported models: `doubao-seed-2.0-pro`, `doubao-seed-2.0-lite`,
        `doubao-seed-2.0-mini`, `doubao-seed-2.0-code`

        - Need more features? Check out [Complete API
        Reference](./doubao-seed-2.0-responses-reference)
      operationId: createResponseQuickDoubaoSeed20
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ResponseQuickRequest'
      responses:
        '200':
          description: Response generated successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseObject'
        '400':
          description: Invalid request parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: 400
                  message: Invalid request parameters
                  type: invalid_request_error
        '401':
          description: Unauthorized, invalid or expired token
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: 401
                  message: Invalid or expired token
                  type: authentication_error
        '402':
          description: Insufficient quota, recharge required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: 402
                  message: Insufficient quota
                  type: insufficient_quota_error
                  fallback_suggestion: https://evolink.ai/dashboard/billing
        '403':
          description: Access denied
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: 403
                  message: Access denied for this model
                  type: permission_error
                  param: model
        '404':
          description: Resource not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: 404
                  message: Specified model not found
                  type: not_found_error
                  param: model
                  fallback_suggestion: doubao-seed-2.0-pro
        '429':
          description: Rate limit exceeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: 429
                  message: Rate limit exceeded
                  type: rate_limit_error
                  fallback_suggestion: retry after 60 seconds
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: 500
                  message: Internal server error
                  type: internal_server_error
                  fallback_suggestion: try again later
        '502':
          description: Upstream service error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: 502
                  message: Upstream AI service unavailable
                  type: upstream_error
                  fallback_suggestion: try different model
        '503':
          description: Service temporarily unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: 503
                  message: Service temporarily unavailable
                  type: service_unavailable_error
                  fallback_suggestion: retry after 30 seconds
components:
  schemas:
    ResponseQuickRequest:
      type: object
      required:
        - model
        - input
      properties:
        model:
          type: string
          description: >-
            Chat model name


            - `doubao-seed-2.0-pro`: Flagship, strongest overall capability,
            ideal for complex reasoning and high-quality generation

            - `doubao-seed-2.0-lite`: Lightweight, faster speed, cost-effective

            - `doubao-seed-2.0-mini`: Ultra-fast, quickest response, suitable
            for simple tasks

            - `doubao-seed-2.0-code`: Code-specialized, optimized for code
            generation and understanding
          enum:
            - doubao-seed-2.0-pro
            - doubao-seed-2.0-lite
            - doubao-seed-2.0-mini
            - doubao-seed-2.0-code
          default: doubao-seed-2.0-pro
          example: doubao-seed-2.0-pro
        input:
          type: string
          description: Input content (plain text), equivalent to text input with user role
          example: Hello, introduce the new features of Doubao Seed 2.0
    ResponseObject:
      type: object
      properties:
        id:
          type: string
          description: Unique identifier of this response
          example: resp_02177148667427813c33c36521378d02b2c8389204fa8c3e2f63e
        object:
          type: string
          description: Object type, fixed as response
          enum:
            - response
          example: response
        created_at:
          type: number
          description: Creation Unix timestamp (seconds)
          example: 1771486674
        model:
          type: string
          description: Actual model name and version used
          example: doubao-seed-2-0-code-preview-260215
        status:
          type: string
          description: |-
            Response status

            - `completed`: Generation completed
            - `in_progress`: Generation in progress
            - `incomplete`: Incomplete
            - `failed`: Failed
          enum:
            - completed
            - in_progress
            - incomplete
            - failed
          example: completed
        output:
          type: array
          description: Model output content list
          items:
            $ref: '#/components/schemas/OutputItem'
        service_tier:
          type: string
          description: Service tier for this request
          example: default
        usage:
          $ref: '#/components/schemas/Usage'
        max_output_tokens:
          type: integer
          description: Maximum output token count
          example: 32768
        caching:
          type: object
          description: Caching configuration
          properties:
            type:
              type: string
              enum:
                - enabled
                - disabled
        store:
          type: boolean
          description: Whether the response was stored
          example: true
        expire_at:
          type: integer
          description: Storage expiration time (Unix timestamp)
          example: 1771745874
        error:
          type: object
          nullable: true
          description: Error information, null on success
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: integer
              description: HTTP status error code
            message:
              type: string
              description: Error message
            type:
              type: string
              description: Error type
            param:
              type: string
              description: Related parameter name
            fallback_suggestion:
              type: string
              description: Suggestion for handling the error
    OutputItem:
      oneOf:
        - $ref: '#/components/schemas/ReasoningOutput'
        - $ref: '#/components/schemas/MessageOutput'
    Usage:
      type: object
      description: Token usage statistics
      properties:
        input_tokens:
          type: integer
          description: Number of input tokens
          example: 88
        input_tokens_details:
          type: object
          description: Input token details
          properties:
            cached_tokens:
              type: integer
              description: Number of cached tokens
              example: 0
        output_tokens:
          type: integer
          description: Number of output tokens
          example: 230
        output_tokens_details:
          type: object
          description: Output token details
          properties:
            reasoning_tokens:
              type: integer
              description: Number of reasoning/chain-of-thought tokens
              example: 211
        total_tokens:
          type: integer
          description: Total number of tokens
          example: 318
    ReasoningOutput:
      title: Chain-of-thought output
      type: object
      properties:
        id:
          type: string
          description: Output item ID
          example: rs_0217****404a
        type:
          type: string
          description: Output type, reasoning for this item
          enum:
            - reasoning
        summary:
          type: array
          description: Chain-of-thought content
          items:
            type: object
            properties:
              text:
                type: string
                description: Chain-of-thought content text
              type:
                type: string
                description: Type, fixed as summary_text
                enum:
                  - summary_text
        status:
          type: string
          description: Status
          enum:
            - in_progress
            - completed
            - incomplete
          example: completed
    MessageOutput:
      title: Message output
      type: object
      properties:
        id:
          type: string
          description: Output item ID
          example: msg_0217****a93c
        type:
          type: string
          description: Output type, message for this item
          enum:
            - message
        role:
          type: string
          description: Role, fixed as assistant
          enum:
            - assistant
        content:
          type: array
          description: Message content list
          items:
            type: object
            properties:
              text:
                type: string
                description: Text content
                example: Hello! Nice to meet you~ How can I help you?
              type:
                type: string
                description: Content type
                enum:
                  - output_text
              annotations:
                type: array
                nullable: true
                description: Annotation information
        status:
          type: string
          description: Status
          enum:
            - in_progress
            - completed
            - incomplete
          example: completed
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        ## All APIs require Bearer Token authentication ##


        **Get API Key:**


        Visit [API Key Management Page](https://evolink.ai/dashboard/keys) to
        get your API Key


        **Add to request header:**

        ```

        Authorization: Bearer YOUR_API_KEY

        ```

````