curl -X POST https://api.openoctopus.com/v1/images/recognitions \\
  -H "Content-Type: application/json" \\
  -H "Authorization: Bearer ooq_your_api_key" \\
  -d '{
  "model": "openoctopus/image-captioner-molmo2",
  "prompt": "a premium octopus mascot, orange and black, clean background"
}'

curl https://api.openoctopus.com/v1/tasks/task_id_from_previous_response \
  -H "Authorization: Bearer ooq_your_api_key"

{
  "model": "openoctopus/your-model",
  "input": {
    "image": "example",
    "face_image": "example",
    "target_index": "0",
    "output_format": "jpeg",
    "enable_base64_output": false,
    "enable_sync_mode": "false"
  }
}

{
  "id": "00000000-0000-0000-0000-000000000000",
  "status": "queued",
  "model": "openoctopus/your-model"
}

{
  "standard": {
    "model": "public model slug (required)",
    "prompt": "user prompt (required)",
    "input": "provider-specific options (optional object)"
  },
  "providerExtension": {
    "params": [
      {
        "name": "image",
        "type": "string (uri)",
        "required": true,
        "description": "Input image URL for captioning. Supports common image formats (JPEG, PNG, WebP).",
        "exposedToCustomer": true
      },
      {
        "enum": [
          "low",
          "medium",
          "high"
        ],
        "name": "detail_level",
        "type": "string",
        "example": "medium",
        "required": false,
        "description": "Level of detail in the generated caption. Low: brief summary. Medium: balanced description. High: comprehensive, detailed analysis.",
        "exposedToCustomer": true
      },
      {
        "name": "enable_sync_mode",
        "type": "boolean",
        "example": "false",
        "required": false,
        "description": "If set to true, the function will wait for the result to be generated and uploaded before returning the response. It allows you to get the result directly in the response. This property is only available through the API.",
        "exposedToCustomer": false
      }
    ]
  }
}

{
  "standard": {
    "id": "task id",
    "status": "queued | processing | succeeded | failed | cancelled",
    "queue": {
      "enabled": "whether OpenOctopus local queue is enabled for this model",
      "position": "1-based queue position while queued, 0 while processing, null when unavailable",
      "size": "current queued request count for this model",
      "concurrency": "local concurrent upstream submissions allowed for this model",
      "upstreamQueueSupported": "whether the upstream provider has a reliable queue",
      "upstreamCancelSupported": "whether the upstream provider supports cancellation"
    },
    "asset_storage": {
      "provider": "supabase | aliyun-oss | tencent-cos",
      "inputBucket": "bucket used for uploaded reference media",
      "outputBucket": "bucket used for generated media",
      "custom": "true when this model overrides default system asset storage"
    },
    "capability": "image_generation | video_generation",
    "output_payload": {
      "format": "openoctopus.image.output.v1 | openoctopus.video.output.v1",
      "assets": "normalized output assets",
      "raw": "optional sanitized debug payload (may be omitted depending on endpoint policy)"
    }
  },
  "providerExtension": {
    "fields": [
      {
        "name": "created_at",
        "type": "string (date-time)",
        "description": "ISO timestamp of when the request was created (e.g., '2023-04-01T12:34:56.789Z').",
        "exposedToCustomer": true
      },
      {
        "name": "has_nsfw_contents",
        "type": "array of boolean",
        "description": "Array of boolean values indicating NSFW detection for each output.",
        "exposedToCustomer": true
      },
      {
        "name": "id",
        "type": "string",
        "description": "Unique identifier for the prediction, the ID of the prediction to get.",
        "exposedToCustomer": true
      },
      {
        "name": "model",
        "type": "string",
        "description": "Model ID used for the prediction.",
        "exposedToCustomer": true
      },
      {
        "name": "outputs",
        "type": "array of string",
        "description": "Array of URLs to the generated content (empty when status is not completed).",
        "exposedToCustomer": true
      },
      {
        "name": "status",
        "type": "string",
        "description": "Status of the task: created, processing, completed, or failed.",
        "exposedToCustomer": true
      },
      {
        "name": "urls",
        "type": "object",
        "example": "[object Object]",
        "description": "Object containing related API endpoints.",
        "exposedToCustomer": true
      }
    ]
  }
}

{
  "capability": "image_generation",
  "status": "succeeded",
  "output_payload": {
    "format": "openoctopus.image.output.v1",
    "assets": [
      {
        "type": "image",
        "url": "https://example.com/result.png",
        "mimeType": "image/png"
      }
    ],
    "raw": {
      "model": "example",
      "outputs": "example",
      "status": "example",
      "urls": "example",
      "created_at": "example",
      "has_nsfw_contents": "example",
      "id": "example"
    }
  }
}