Primera Llamada API

Esta guía demuestra cómo hacer tu primera llamada API. Puedes usar cualquier cliente HTTP o lenguaje.

Formato de Solicitud

Todas las solicitudes API de Poomi siguen este patrón:

curl https://www.poomi.pet/api/v1/{endpoint-slug} \
  -H "Authorization: Bearer pk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{ ... }'

Ejemplo

Este ejemplo envía una imagen a un endpoint. Reemplaza {endpoint-slug} con un endpoint real de la página de Endpoints.

curl https://www.poomi.pet/api/v1/{endpoint-slug} \
  -H "Authorization: Bearer pk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "base64_encoded_image_data"
  }'

Ejemplo en Python

import requests
import base64

# Leer y codificar la imagen
with open("pet_photo.jpg", "rb") as f:
    image_data = base64.b64encode(f.read()).decode()

response = requests.post(
    "https://www.poomi.pet/api/v1/{endpoint-slug}",
    headers={
        "Authorization": "Bearer pk_your_api_key_here",
        "Content-Type": "application/json",
    },
    json={"image": image_data},
)

result = response.json()
print(result)

Respuesta Exitosa

{
  "success": true,
  "request_id": "req_abc123def456",
  "data": {
    ...
  }
}

Respuesta de Error

{
  "success": false,
  "error": {
    "code": "INVALID_KEY",
    "message": "Invalid API key"
  }
}

Campos de Solicitud

Campo	Tipo	Descripción
`image`	string	Datos de imagen codificados en Base64. Formatos soportados: JPG, PNG, WEBP. Tamaño máximo: 4MB.
`text`	string	Entrada de texto (para endpoints de texto)

Los campos exactos dependen del tipo de entrada del endpoint (image, text o image_text). Consulta Endpoints para más detalles sobre cada endpoint.

Directrices de Imagen

Formatos soportados: JPG, PNG, WEBP
Tamaño máximo: 4MB
Resolución recomendada: al menos 640x480 para mejores resultados
Asegura buena iluminación y evita imágenes borrosas
Centra al sujeto (mascota) en el encuadre

Campos de Respuesta

Campo	Tipo	Descripción
`success`	boolean	Si la solicitud fue exitosa
`request_id`	string	ID de solicitud único (prefijo `req_`)
`data`	object	Salida del modelo AI (el esquema varía por endpoint)

On this page