Stability AI 3D Generation API

openapi: 3.1.0
info:
  title: Stability AI Stable Fast 3D 3D Generation API
  description: The Stability AI Stable Fast 3D API generates textured 3D mesh assets from single input images. The API rapidly produces 3D models suitable for use in games, augmented reality, virtual reality, and product visualization workflows. Developers can convert 2D images into fully textured 3D objects with UV-unwrapped meshes, enabling rapid prototyping and asset creation without manual 3D modeling.
  version: v2beta
  contact:
    name: Stability AI Support
    url: https://platform.stability.ai
  termsOfService: https://stability.ai/terms-of-service
servers:
- url: https://api.stability.ai
  description: Production Server
security:
- bearerAuth: []
tags:
- name: 3D Generation
  description: Generate textured 3D mesh assets from single input images using the Stable Fast 3D model.
paths:
  /v2beta/3d/stable-fast-3d:
    post:
      operationId: generateStableFast3D
      summary: Generate a 3D model from an image
      description: Generates a textured, UV-unwrapped 3D mesh from a single input image. The model interprets the 2D image and produces a 3D object with geometry and texture suitable for real-time rendering applications. Output is returned as a GLB file containing the mesh and texture data.
      tags:
      - 3D Generation
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/StableFast3DRequest'
      responses:
        '200':
          description: Successfully generated 3D model
          content:
            model/gltf-binary:
              schema:
                type: string
                format: binary
            application/json:
              schema:
                $ref: '#/components/schemas/Generate3DResponse'
        '400':
          description: Bad request due to invalid parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized due to missing or invalid API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Forbidden due to content moderation or insufficient permissions
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: Rate limit exceeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    StableFast3DRequest:
      type: object
      required:
      - image
      properties:
        image:
          type: string
          format: binary
          description: The input image of an object to convert into a 3D model. Best results are achieved with images of single objects on a clean background.
        texture_resolution:
          type: integer
          enum:
          - 512
          - 1024
          - 2048
          default: 1024
          description: The resolution of the generated texture in pixels. Higher values produce more detailed textures but increase file size and processing time.
        foreground_ratio:
          type: number
          minimum: 0.1
          maximum: 1.0
          default: 0.85
          description: The ratio of the foreground object to the total image size. Used to control how much of the image is treated as the object versus background during 3D reconstruction.
        remesh:
          type: string
          enum:
          - none
          - triangle
          - quad
          default: none
          description: The remeshing algorithm to apply to the generated mesh. Triangle and quad remeshing produce cleaner topology suitable for animation and further editing.
    Generate3DResponse:
      type: object
      properties:
        model:
          type: string
          description: Base64-encoded GLB model data when Accept header is set to application/json.
        finish_reason:
          type: string
          enum:
          - SUCCESS
          - CONTENT_FILTERED
          description: The reason the generation finished.
    ErrorResponse:
      type: object
      properties:
        id:
          type: string
          description: A unique identifier for the error instance.
        name:
          type: string
          description: The error type name.
        message:
          type: string
          description: A human-readable description of the error.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API key authentication. Pass your Stability AI API key as a Bearer token in the Authorization header.
externalDocs:
  description: Stability AI API Documentation
  url: https://platform.stability.ai/docs/api-reference