API Access

import requests

ZAPI_KEY = "your_api_key_here"
ZAPI_URL = "https://api.zentropi.ai/v1/label"

content_text = "This is a funny joke"
criteria_text = "Label jokes"

response = requests.post(
    ZAPI_URL,
    headers={"Authorization": f"Bearer {ZAPI_KEY}"},
    json={
        "content_text": content_text,
        "criteria_text": criteria_text,
    }
)

result = response.json()
print(f"Label: {result['label']}")
print(f"Confidence: {result['confidence']}")

# Example output:
# Label: 1
# Confidence: 0.85

# For multimodal examples, see this notebook:
# https://colab.research.google.com/drive/1jfMkpaoX5lAKoGpqVUeyv_4haGn1BUX6

const ZAPI_KEY = "your_api_key_here";
const ZAPI_URL = "https://api.zentropi.ai/v1/label";

// Label content using Z-API
const labelContent = async () => {
  const response = await fetch(ZAPI_URL, {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${ZAPI_KEY}`,
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      content_text: "This is a funny joke",
      criteria_text: "Label jokes"
    })
  });

  const result = await response.json();
  console.log(`Label: ${result.label}`);
  console.log(`Confidence: ${result.confidence}`);
};

labelContent();

// Example output:
// Label: 1
// Confidence: 0.85

import requests

ZAPI_KEY = "your_api_key_here"
ZAPI_URL = "https://api.zentropi.ai/v1/multilabel"

response = requests.post(
    ZAPI_URL,
    headers={"Authorization": f"Bearer {ZAPI_KEY}"},
    json={
        "model": "cope-b-s1",
        "content_text": "The vase arrived cracked. Please refund my payment.",
        "labelers": [
            {
                "key": "refund",
                "criteria_text": "The customer requests a refund.",
            },
            {
                "key": "damage",
                "criteria_text": "The customer reports a damaged product.",
            },
        ],
    },
    timeout=120,
)
response.raise_for_status()

# Results are in the same order as the requested labelers.
results = response.json()
for result in results:
    print(f"{result['key']}: {result['label']} (confidence: {result['confidence']})")

# Shared compute time; do not sum across results.
print(f"Compute time: {results[0]['compute_time']} seconds")

const ZAPI_KEY = "your_api_key_here";
const ZAPI_URL = "https://api.zentropi.ai/v1/multilabel";

const labelContent = async () => {
  const response = await fetch(ZAPI_URL, {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${ZAPI_KEY}`,
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      model: "cope-b-s1",
      content_text: "The vase arrived cracked. Please refund my payment.",
      labelers: [
        {
          key: "refund",
          criteria_text: "The customer requests a refund."
        },
        {
          key: "damage",
          criteria_text: "The customer reports a damaged product."
        }
      ]
    })
  });
  if (!response.ok) {
    throw new Error(`HTTP ${response.status}: ${await response.text()}`);
  }

  // Results are in the same order as the requested labelers.
  const results = await response.json();
  for (const result of results) {
    console.log(`${result.key}: ${result.label} (confidence: ${result.confidence})`);
  }

  // Shared compute time; do not sum across results.
  console.log(`Compute time: ${results[0].compute_time} seconds`);
};

labelContent().catch(console.error);