Nereo Overview API

openapi: 3.1.0
info:
  title: Nereo Overview API
  version: '2026-10-30'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-30: 3 operation(s) read from 3 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; Nereo has published no machine-readable contract that the pipeline
    could find. Engine: anthropic.'
  x-evidence-tiers:
    code-example: 8
    documentation: 0
    pages-with-code: 33
    pages-read: 40
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-30'
  x-generator: generate-contract-from-docs.py
  x-engine: anthropic
  x-sources:
  - https://api.nereo.io/docs/api-reference/create-upload-url
  - https://api.nereo.io/docs/api-reference/get-request-status
  - https://api.nereo.io/docs/api-reference/submit-request
  x-docs-section: api-reference
paths:
  /:
    get:
      operationId: get
      tags:
      - Api
      summary: GET /
      x-source: https://api.nereo.io/docs/api-reference/get-request-status
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl \" $API_BASE /api/v1/requests/7c1k2n0q8x4m3v9d5a6b/status\"  -H \"Authorization: Bearer $API_KEY \" \n Responses Copy Anchor\
          \ Link \n 200 OK Copy Text { \n \"request_id\" : \"7c1k2n0q8x4m3v9d5a6b\" , \n \"endpoint_id\" : \"byteplus/seedance-2.0-mini/text-to-video\"\
          \ , \n \"status\" : \"completed\" , \n \"status_url\" : \"https://<this site>/api/v1/requests/7c1k2n0q8x4m3v9d5a6b/status\" , \n \"\
          outputs\" : [ \n { \"url\" : \"htt"
    post:
      operationId: post
      tags:
      - Api
      summary: POST /
      x-source: https://api.nereo.io/docs/api-reference/create-upload-url
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostRequest'
      responses:
        '201':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X POST \" $API_BASE /api/v1/storage/upload\"  -H \"Authorization: Bearer $API_KEY \"  -H \"Content-Type: application/json\"\
          \  -d '{ \"content_type\": \"image/png\" }' \n Responses Copy Anchor Link \n 200 OK Copy Text { \n \"upload_url\" : \"https://…\" ,\
          \ \n \"public_url\" : \"https://…/media/0b6f….png\" , \n \"expires_in\" : 900 \n } \n Field Type Description upload_url string PUT the\
          \ file here, with exactly the Conten"
  /first-frame.png:
    post:
      operationId: post_first_frame_png
      tags:
      - First Frame
      summary: POST /first-frame.png
      x-source: https://api.nereo.io/docs/api-reference/submit-request
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostFirstFramePngRequest'
      responses:
        '201':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostFirstFramePngResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X POST \" $API_BASE /api/v1/byteplus/seedance-2.0-mini/image-to-video\"  -H \"Authorization: Bearer $API_KEY \"  -H \"\
          Content-Type: application/json\"  -d '{ \n \"prompt\": \"The camera slowly pushes in\", \n \"image_url\": \"https://example.com/first-frame.png\"\
          , \n \"duration\": 5 \n }' \n Responses Copy Anchor Link \n 200 OK Copy Text { \n \"status\" : \"queued\" , \n \"request_id\" : \"7c1k2n0q8x4m3v9d5a6b\"\
          \ , \n \"statu"
security:
- bearer: []
components:
  schemas:
    GetResponse:
      type: object
      properties:
        request_id:
          type: string
        endpoint_id:
          type: string
        status:
          type: string
        status_url:
          type: string
        outputs:
          type: array
          items:
            type: object
            properties:
              url:
                type: string
              mime_type:
                type: string
        created_at:
          type: string
          format: date-time
        finished_at:
          type: string
          format: date-time
    PostRequest:
      type: object
      properties:
        content_type:
          type: string
    PostResponse:
      type: object
      properties:
        upload_url:
          type: string
        public_url:
          type: string
        expires_in:
          type: integer
    PostFirstFramePngRequest:
      type: object
      properties:
        prompt:
          type: string
        image_url:
          type: string
        duration:
          type: integer
    PostFirstFramePngResponse:
      type: object
      properties:
        status:
          type: string
        request_id:
          type: string
        status_url:
          type: string
        cancel_url:
          type: string
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
tags:
- name: Api
- name: First Frame