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

# OpenAI Multimodal

> Fully compatible with OpenAI Responses API format. Supports multimodal input (text/images), tool extensions, function calling, and streaming.



## OpenAPI

````yaml post /v1/responses
openapi: 3.1.0
info:
  title: General Chat API
  version: 1.0.0
  description: >-
    Unified chat API interface supporting multiple text-generation models.
    Compatible with OpenAI Chat Completions API format.
servers:
  - url: https://apiif.com
    description: Primary API server
security:
  - bearerAuth: []
paths:
  /v1/responses:
    post:
      summary: OpenAI Multimodal
      description: >-
        Fully compatible with OpenAI Responses API format. Supports multimodal
        input (text/images), tool extensions, function calling, and streaming.
      operationId: createOpenAIResponse
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                model:
                  type: string
                  description: Model name, e.g. gpt-5
                input:
                  type: array
                  items:
                    type: object
                    properties:
                      role:
                        type: string
                        enum:
                          - user
                          - assistant
                          - system
                      content:
                        type: array
                        items:
                          type: object
                          properties:
                            type:
                              type: string
                              description: input_text or input_image
                            text:
                              type: string
                            image_url:
                              type: string
                              format: uri
                    required:
                      - role
                      - content
                  minItems: 1
                temperature:
                  type: number
                max_tokens:
                  type: integer
                stream:
                  type: boolean
                top_p:
                  type: number
                tools:
                  type: array
                  items:
                    type: object
              required:
                - model
                - input
            examples:
              basic:
                value:
                  model: gpt-5
                  input:
                    - role: user
                      content:
                        - type: input_text
                          text: What is in this image?
                        - type: input_image
                          image_url: >-
                            https://openai-documentation.vercel.app/images/cat_and_otter.png
      responses:
        '200':
          description: Successful response following OpenAI Responses API format.
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: integer
                  data:
                    type: object
                    properties:
                      id:
                        type: string
                      object:
                        type: string
                        example: response
                      created:
                        type: integer
                      model:
                        type: string
                      choices:
                        type: array
                        items:
                          type: object
                          properties:
                            index:
                              type: integer
                            message:
                              type: object
                              properties:
                                role:
                                  type: string
                                content:
                                  type: string
                            finish_reason:
                              type: string
                      usage:
                        type: object
                        properties:
                          prompt_tokens:
                            type: integer
                          completion_tokens:
                            type: integer
                          total_tokens:
                            type: integer
              examples:
                success:
                  value:
                    code: 200
                    data:
                      id: resp-9876543210
                      object: response
                      created: 1677652288
                      model: gpt-5
                      choices:
                        - index: 0
                          message:
                            role: assistant
                            content: >-
                              This image shows a cat and an otter. They appear
                              to be interacting with each other in a very cute
                              and heartwarming scene.
                          finish_reason: stop
                      usage:
                        prompt_tokens: 156
                        completion_tokens: 45
                        total_tokens: 201
        '400':
          description: Invalid request parameters
          content:
            application/json:
              examples:
                bad_request:
                  value:
                    error:
                      code: 400
                      message: Invalid request parameters
                      type: invalid_request_error
        '401':
          description: Authentication failed
          content:
            application/json:
              examples:
                unauthorized:
                  value:
                    error:
                      code: 401
                      message: Authentication failed, please check your API key
                      type: authentication_error
        '402':
          description: Payment required / insufficient balance
          content:
            application/json:
              examples:
                payment_required:
                  value:
                    error:
                      code: 402
                      message: >-
                        Insufficient account balance, please top up and try
                        again
                      type: payment_required
        '403':
          description: Access forbidden
          content:
            application/json:
              examples:
                forbidden:
                  value:
                    error:
                      code: 403
                      message: >-
                        Access forbidden, you do not have permission to access
                        this resource
                      type: permission_error
        '429':
          description: Rate limit exceeded
          content:
            application/json:
              examples:
                rate_limited:
                  value:
                    error:
                      code: 429
                      message: Too many requests, please try again later
                      type: rate_limit_error
        '500':
          description: Internal server error
          content:
            application/json:
              examples:
                server_error:
                  value:
                    error:
                      code: 500
                      message: Internal server error, please try again later
                      type: server_error
        '502':
          description: Bad gateway
          content:
            application/json:
              examples:
                bad_gateway:
                  value:
                    error:
                      code: 502
                      message: Gateway error, server temporarily unavailable
                      type: bad_gateway
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: 'All endpoints require `Authorization: Bearer YOUR_API_KEY`.'

````