Token Count

Calculate the token count for a conversation. The request format is similar to the Chat Completion API.

Endpoint

POST https://api.stepfun.ai/v1/token/count

Request parameters

• model string required
  Model name to use.
• messages object array required
  Conversation so far, including user and assistant messages.

Show child attributes

• System message object

  Show child attributes

  • role string
    Always system.
  • content string
    System message text.

• User message object

  Show child attributes

  • role string
    Always user.

  • content string or object array
    User message content: either a multipart list or a plain text string.

    Show child attributes

    • Plain text string
      Directly pass a string as the message content.

    • multipart list object array
      Structured multimodal message.

      Show child attributes

      • Text message object

        Show child attributes

        • type string
          Always text.
        • text string
          Text content.

      • Image message object

        Show child attributes

        • type string
          Always image_url.

        • image_url object

          Show child attributes

          • url string
            Image URL or base64 string.

            URLs support only http and https.

            Base64 example: data:image/jpeg;base64,${base64_string} (replace jpeg with your format and the encoded data).

            Supported image formats: jpg/jpeg, png, webp, static gif.

• Assistant message object

  Show child attributes

  • role string
    Always assistant.
  • content string | null
    Assistant message text.

Response

• data object
  Token count result.

  Show child attributes

  • total_tokens int
    Total tokens in the request.

Examples

Text chat

curl https://api.stepfun.ai/v1/token/count \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $STEP_API_KEY" \
  -d '{
    "model": "step-3.7-flash",
    "messages": [
      {
        "role": "system",
        "content": "You are an AI assistant provided by StepFun. You excel at conversations in Chinese, English, and other languages. While keeping user data safe, you should answer quickly and accurately, and reject any content related to pornography, drugs, gambling, violence, or terrorism."
      },
      {
        "role": "user",
        "content": "Hi, please introduce StepFun'\''s AI!"
      }
    ]
  }'

{
  "data": {
    "total_tokens": 85
  }
}

Mixed media

curl https://api.stepfun.ai/v1/token/count \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $STEP_API_KEY" \
  -d '{
    "model": "step-3.7-flash",
    "messages": [
      {
        "role": "system",
        "content": "You are an AI assistant provided by StepFun. You excel at Chinese, English, and many other languages, and you can describe user-provided images precisely. Keep user data safe, answer quickly and accurately, and refuse content related to pornography, drugs, gambling, violence, or terrorism."
      },
      {
        "role": "user",
        "content": [
          {
            "type": "text",
            "text": "Describe this picture in elegant language."
          },
          {
            "type": "image_url",
            "image_url": {
              "url": "https://www.stepfun.com/assets/section-1-CTe4nZiO.webp"
            }
          }
        ]
      }
    ]
  }'

{
  "data": {
    "total_tokens": 497
  }
}

Base64 image

# Load an image into memory (demo only; read from a file as needed)
image_base64="data:image/webp;base64,"$(curl -s "https://www.stepfun.com/assets/section-1-CTe4nZiO.webp" | base64)

curl https://api.stepfun.ai/v1/token/count \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $STEP_API_KEY" \
  -d "{
    \"model\": \"step-3.7-flash\",
    \"messages\": [
      {
        \"role\": \"system\",
        \"content\": \"You are an AI assistant provided by StepFun. You excel at Chinese, English, and many other languages, and you can describe user-provided images precisely. Keep user data safe, answer quickly and accurately, and refuse content related to pornography, drugs, gambling, violence, or terrorism.\"
      },
      {
        \"role\": \"user\",
        \"content\": [
          {
            \"type\": \"text\",
            \"text\": \"Describe this image in elegant language.\"
          },
          {
            \"type\": \"image_url\",
            \"image_url\": {
              \"url\": \"${image_base64}\"
            }
          }
        ]
      }
    ]
  }"

{
  "data": {
    "total_tokens": 497
  }
}