Inicio rápido de la API común

La API común ofrece servicios de utilidad fundamentales para gestionar tu cuenta de 97AI.PRO y manejar el contenido generado. Estas APIs te ayudan a supervisar el uso de créditos y acceder eficientemente a los archivos generados.

Todas las solicitudes a la API requieren autenticación con un token Bearer. Obtén tu API key en la página de gestión de API keys y mantenla segura.

https://97ai.97claude.com

Encabezado de autorización

Authorization: Bearer YOUR_API_KEY

Dos operaciones básicas: consulta tu saldo de créditos y luego descarga los archivos de resultado de una tarea finalizada.

curl -X GET "https://97ai.97claude.com/api/credits" \
  -H "Authorization: Bearer YOUR_API_KEY"

Ejemplo de respuesta

{
  "credits": 1950
}

Cuando una tarea termina, GET /api/generate/{taskId} devuelve resultUrls: URLs directas y descargables del contenido generado:

curl -X GET "https://97ai.97claude.com/api/generate/task_12345678" \
  -H "Authorization: Bearer YOUR_API_KEY"
# → { "state": "success", "resultUrls": ["https://…/out.jpg"], … }

curl -o out.jpg "https://…/out.jpg"

Consultar créditos de la cuenta — GET /api/credits

• Obtén el saldo de créditos en tiempo real
• No requiere parámetros; respuesta inmediata
• Esencial para supervisar el uso y las alertas de umbral de créditos

Resultados de la tarea — GET /api/generate/{taskId}

• resultUrls cubre todos los tipos de archivo generados (imágenes, videos, audio, etc.)
• Las URLs son directamente descargables, sin paso de intercambio adicional
• Los archivos se conservan 14 días y luego se eliminan automáticamente

Un cliente automatizado de supervisión de créditos:

class Ai97Client {
  constructor(apiKey) {
    this.apiKey = apiKey;
    this.baseUrl = 'https://97ai.97claude.com';
  }
  async getCredits() {
    const res = await fetch(this.baseUrl + '/api/credits', {
      headers: { 'Authorization': 'Bearer ' + this.apiKey }
    });
    if (!res.ok) throw new Error('Failed to get credits: ' + res.statusText);
    return (await res.json()).credits;
  }
  async getResultUrls(taskId) {
    const res = await fetch(this.baseUrl + '/api/generate/' + taskId, {
      headers: { 'Authorization': 'Bearer ' + this.apiKey }
    });
    const j = await res.json();
    return j.state === 'success' ? j.resultUrls : null;
  }
  async checkCreditsAndWarn(threshold = 10) {
    const credits = await this.getCredits();
    if (credits < threshold) { console.warn('Low credits: ' + credits); return false; }
    return true;
  }
}

Errores comunes: 401 No autorizado (clave ausente/no válida), 402 Créditos insuficientes, 403 Prohibido (la clave no tiene permiso para el modelo), 404 No encontrado (taskId desconocido), 500 Error del servidor.

Correo: [email protected] · Documentación: https://97ai.97claude.com/docs · Estado de la API: consulta la salud en tiempo real en cada página de modelo.