---
updatedAt: 2026-04-23T14:31:17.000Z
agentTools:
  projectIndex: https://docs.bynn.com/llms.txt
---

# Get inference result

Retrieve the result of a moderation inference by token

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "BYNN API",
    "description": "The BYNN API is organized around REST. Our API has predictable, resource-oriented URLs, and uses HTTP response codes to indicate API errors. We use built-in HTTP features, like HTTP authentication and HTTP verbs, which are understood by off-the-shelf HTTP clients. We support cross-origin resource sharing, allowing you to interact securely with our API from a client-side web application (though you should never expose your secret API key in any public website’s client-side code). JSON is returned by all API responses, including errors, although our API libraries convert responses to appropriate language-specific objects. To make the API as explorable as possible, accounts have test mode and live mode API keys. There is no “switch” for changing between modes, just use the appropriate key to perform a live or test transaction. Requests made with test-mode credentials never hit live networks and incur no cost. **AUTHENTICATION:** Please use your **Private API Key** that looks like this `private_Nv7UpwQbSmWtUTiSWfw1bdHm` as the username and password in HTTP basic auth.",
    "termsOfService": "https://bynn.com/terms",
    "contact": {
      "name": "BYNN Development Team",
      "email": "hello@bynn.com",
      "url": "https://docs.bynn.com"
    },
    "license": {
      "name": "BYNN Documentation",
      "url": "https://docs.bynn.com"
    },
    "version": "1.0"
  },
  "tags": [
    {
      "name": "moderation",
      "description": "Operations about moderations"
    }
  ],
  "paths": {
    "/moderation/inference/{token}": {
      "get": {
        "summary": "Get inference result",
        "description": "Retrieve the result of a moderation inference by token",
        "parameters": [
          {
            "in": "path",
            "name": "token",
            "description": "The inference token (e.g., inf_abc123)",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "security": [
          {
            "PrivateKey": []
          }
        ],
        "responses": {
          "200": {
            "description": "Get inference result",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Bynn_V1_Entities_InferenceEntity"
                }
              }
            }
          }
        },
        "tags": [
          "moderation"
        ],
        "operationId": "getModerationInferenceToken"
      }
    }
  },
  "servers": [
    {
      "url": "//api.bynn.com/v1"
    }
  ],
  "components": {
    "securitySchemes": {
      "PrivateKey": {
        "type": "apiKey",
        "name": "Authorization",
        "in": "header",
        "description": "Enter your PRIVATE KEY token prefixed with `Bearer `, e.g. `Bearer your_token_here`"
      }
    },
    "schemas": {
      "Bynn_V1_Entities_InferenceEntity": {
        "type": "object",
        "properties": {
          "inference_id": {
            "type": "string",
            "example": "inf_abc123def456",
            "description": "Unique inference identifier"
          },
          "model_id": {
            "type": "string",
            "example": "nudity_detection",
            "description": "The model used for this inference"
          },
          "model_name": {
            "type": "string",
            "example": "Nudity & Adult Content",
            "description": "The model display name"
          },
          "moderation_type": {
            "type": "string",
            "example": "image",
            "description": "Type of moderation (image, video, audio, text)"
          },
          "status": {
            "type": "string",
            "enum": [
              "pending",
              "processing",
              "completed",
              "failed"
            ],
            "example": "completed",
            "description": "Current status of the inference"
          },
          "result": {
            "type": "object",
            "description": "The moderation result data"
          },
          "input_url": {
            "type": "string",
            "example": "https://example.com/image.jpg",
            "description": "URL of the input file/content that was moderated, or indicator of base64 upload"
          },
          "ip_address": {
            "type": "string",
            "example": "192.168.1.1",
            "description": "IP address from which the inference request originated"
          },
          "response_time_ms": {
            "type": "integer",
            "format": "int32",
            "example": 150,
            "description": "Response time in milliseconds"
          },
          "error_message": {
            "type": "string",
            "description": "Error message if the inference failed"
          },
          "created_at": {
            "type": "string",
            "example": "2024-01-15T10:30:00Z",
            "description": "When the inference was created"
          },
          "completed_at": {
            "type": "string",
            "description": "When the inference was completed"
          },
          "duration_seconds": {
            "type": "number",
            "example": 135.5,
            "description": "Duration of the media file in seconds (for video/audio models)"
          },
          "billable_quantity": {
            "type": "integer",
            "format": "int32",
            "example": 3,
            "description": "Number of billable units (minutes for video/audio, images for batch)"
          },
          "cost": {
            "type": "string",
            "example": "$0.00010",
            "description": "Total cost of this inference (formatted with 5 decimals). Returns null for failed inferences."
          }
        },
        "required": [
          "inference_id",
          "model_id",
          "model_name",
          "moderation_type",
          "status",
          "result",
          "input_url",
          "ip_address",
          "response_time_ms",
          "created_at",
          "completed_at",
          "duration_seconds",
          "billable_quantity",
          "cost"
        ],
        "description": "Bynn_V1_Entities_InferenceEntity model"
      }
    }
  }
}
```