Docs
    Docs
    • Introduction
    • Quick Start Guide
    • Make a request
    • Chat Models
      • ChatGpt
        • ChatGPT (Audio)
          • Create a voice
          • Create a transcript
          • Create translation
        • ChatGPT (Chat)
          • Chat completion object
          • Create chat completion (streaming)
          • Create chat completion (non-streaming)
          • Create chat image recognition (streaming)
          • Create chat image recognition (streaming) base64
          • Create chat image recognition (non-streaming)
          • Function calling
          • N choices
          • Create chat function call (only non-streaming)
          • Create structured output
        • ChatGPT (Completions)
          • Completion object
          • Creation completed
        • ChatGPT(Embeddings)
          • Embedded Object
          • Create embed
      • Anthropic Claude
        • Create chat completion (streaming)
        • Create chat completion (non-streaming)
        • Create chat image recognition (streaming)
        • Create chat image recognition (non-streaming)
      • Gemini
        • Gemini Image creation interface (gemini-2.0-flash-exp-image-generation)
        • Chat interface
        • Image recognition interface
    • Image Models
      • MJ
        • Submit Imagine task (mj_imagine)
        • Submit Blend task (mj_blend)
        • Submit Describe task (mj_describe)
        • Submit Change task (mj_variation, mj_upscale,mj_reroll)
        • Query task status based on task ID
      • Ideogram
        • Generate with Ideogram 3.0
        • Edit with Ideogram 3.0
        • Remix with Ideogram 3.0
      • Kling Image
        • Submit Image Generation
        • Get Image by Task ID
        • Submit Kolors Virtual Try On
        • Get Kolors Virtual Try On by Task ID
      • DALL·E 3
        POST
      • Flux (OpenAI dall-e-3 format)
        POST
    • Video Models
      • Kling Video
        • Create Video by Text
        • Get Video by Task ID(text2video)
        • Create Video by Image
        • Get Video by Task ID(image2video)
      • Runway ML Video
        • Create Video by Runway
        • Get Video by Task ID
      • Luma Video
        • Create Video by Luma
        • Get Video by Task ID
      • Pika Video
        • Create Video by Pika
        • Get Video by Task ID
    • Music Model - Suno
      • Illustrate
      • Parameter
      • Task submission
        • Generate songs (inspiration, customization, continuation)
        • Generate lyrics
      • Query interface
        • Query a single task
    • Python Samples
      • python openai official library (using AutoGPT, langchain, etc.)
      • Python uses speech to text
      • Python uses text to speech
      • Python uses Embeddings
      • python calls DALL·E
      • python simple call openai function-calling demo
      • python langchain
      • python llama_index
      • Python uses gpt-4o to identify pictures-local pictures
      • python library streaming output
      • Python uses gpt-4o to identify images
    • Plug-in/software usage tutorials
      • Setting HTTP for Make.com with Yescale
      • Sample Code for gpt-4o-audio/gpt-4o-mini-audio
    • Help Center
      • HTTP status codes

    Make a request

    You can paste the following command into your terminal to run your first API request. Make sure to replace YOUR_API_KEY with your secret API key.
    This request queries the model to complete a text prompt starting with "Say this is a test" using the gpt-3.5-turbo model. You should receive a response similar to the following:
    {
       "id": "chatcmpl-abc123",
       "object": "chat.completion",
       "created": 1677858242,
       "model": "gpt-3.5-turbo-0301",
       "usage": {
          "prompt_tokens": 13,
          "completion_tokens": 7,
          "total_tokens": 20
       },
       "choices": [
          {
             "message": {
                "role": "assistant",
                "content": "\n\nThis is a test!"
             },
             "finish_reason": "stop",
             "index": 0
          }
       ]
    }
    Now you’ve generated your first chat completion. We can see that the finish_reason is stop, which means the API returned a complete response generated by the model. In the above request, we generated only one message, but you can configure the n parameter to generate multiple message options.
    In this example, gpt-3.5-turbo is used primarily for traditional text completion tasks. The model is also optimized for chat-based applications.
    Previous
    Quick Start Guide
    Next
    Create a voice
    Built with