Open AI (ChatGPT)
🇺🇸 English
  • 🇺🇸 English
  • 🇯🇵 Japanese
  • 🇵🇹 Portuguese
  • 🇰🇷 Korea
  • 🇩🇪 German
    Open AI (ChatGPT)
    🇺🇸 English
    • 🇺🇸 English
    • 🇯🇵 Japanese
    • 🇵🇹 Portuguese
    • 🇰🇷 Korea
    • 🇩🇪 German
    • README
    • Introduction
    • Authentication
    • Making requests
    • Streaming
    • Debugging requests
    • Backward compatibility
    • Administration
    • Audio
      • Create speech
        POST
      • Create transcription
        POST
      • Create translation
        POST
    • Chat
      • Create chat completion
        POST
    • Embeddings
      • Create embeddings
        POST
    • Fine-tuning
      • Create fine-tuning job
        POST
      • List fine-tuning jobs
        GET
      • List fine-tuning events
        GET
      • List fine-tuning checkpoints
        GET
      • Retrieve fine-tuning job
        GET
      • Cancel fine-tuning
        POST
    • Batch
      • Create batch
        POST
      • Retrieve batch
        GET
      • Cancel batch
        POST
      • List batch
        GET
    • Files
      • README
      • Upload file
        POST
      • List files
        GET
      • Retrieve file
        GET
      • Delete file
        DELETE
      • Retrieve file content
        GET
    • Uploads
      • Create upload
      • Add upload part
      • Complete upload
    • Images
      • README
      • Create image
      • Create image edit
      • Create image variation
    • Models
      • List models
      • Retrieve model
      • Delete a fine-tuned model
    • Moderations
      • Create moderation
    • Invites
      • List invites
      • Create invite
      • Retrieve invite
      • Delete invite
    • Users
      • List users
      • Modify user
      • Retrieve user
    • Projects
      • List projects
      • Create project
      • Retrieve project
      • Modify project
      • Archive project
    • Project users
      • List project users
      • Create project user
      • Retrieve project user
      • Modify project user
      • Delete project user
      • Create project service account
    • Project service accounts
      • List project service accounts
      • Create project service account
      • Retrieve project service account
      • Delete project service account
    • Project API keys
      • List project API keys
      • Retrieve project API key
      • Delete project API key
    • Project rate limits
      • List project rate limits
      • Modify project rate limit
    • Audit logs
      • List audit logs
    • Usage
      • Completions
      • Embeddings
      • Moderations
      • Images
      • Audio speeches
      • Audio transcriptions
      • Vector stores
      • Code interpreter sessions
      • Costs
    • Completions
      • Create completion
    • Assistants (v1)
      • Create assistant (v1)
      • Create assistant file (v1)
      • List assistants (v1)
      • List assistant files (v1)
      • Retrieve assistant (v1)
      • Retrieve assistant file (v1)
      • Modify assistant (v1)
      • Delete assistant (v1)
      • Delete assistant file (v1)
    • Threads (v1)
      • Create thread (v1)
      • Retrieve thread (v1)
      • Modify thread (v1)
      • Delete thread (v1)
    • Messages (v1)
      • Create message (v1)
      • List messages (v1)
      • List message files (v1)
      • Retrieve message (v1)
      • Retrieve message file (v1)
      • Modify message (v1)
    • Runs (v1)
      • Create run (v1)
      • Create thread and run (v1)
      • List runs (v1)
      • List run steps (v1)
      • Retrieve run (v1)
      • Retrieve run step (v1)
      • Modify run (v1)
      • Submit tool outputs to run (v1)
      • Cancel a run (v1)

    Backward compatibility

    OpenAI is committed to providing stability to API users by avoiding breaking changes in major API versions whenever reasonably possible. This includes:
    The REST API (currently v1)
    Our first-party SDKs (released SDKs will adhere to semantic versioning)
    Model families (like gpt-4o or o1-mini)
    Backwards-compatible changes and upgrades will be continuously delivered over time. These and any rare breaking changes will be communicated in the changelog. Here are some examples of changes which we consider to be backwards-compatible (non-breaking) changes.
    Changes in model prompting behavior between snapshots
    Model outputs are by their nature variable, so changes in prompting and model behavior between snapshots should be expected. For example, if you moved from gpt-4o-2024-05-13 to gpt-4o-2024-08-06, the same system or user messages could function differently between versions. The best way to ensure consistent prompting behavior and model output is to use pinned model versions, and to implement evals for your applications.
    Backwards-compatible API changes
    Adding new resources (URLs) to the REST API and SDKs
    Adding new optional API parameters
    Adding new properties to JSON response objects or event data
    Changing the order of properties in a JSON response object
    Changing the length or format of opaque strings, like resource identifiers and UUIDs
    Adding new event types (in either streaming or the Realtime API)
    Previous
    Debugging requests
    Next
    Administration
    Built with