Errors

from envizion import EnvizionClient
from envizion.exceptions import (
    EnvizionError,
    AuthenticationError,
    RateLimitError,
    NotFoundError,
    InsufficientCreditsError,
    ValidationError,
    ServerError,
)

client = EnvizionClient(api_key="vk_...")

try:
    run = client.runs.create(
        agent_id="creative_director",
        inputs={"topic": "AI news"}
    )
except AuthenticationError as e:
    # 401 or 403: bad key or missing scopes
    print(f"Auth failed: {e}")
    print(f"Status: {e.status_code}")

except RateLimitError as e:
    # 429: rate limited
    print(f"Rate limited. Retry after {e.retry_after}s")

except NotFoundError:
    # 404: agent not found
    print("Agent does not exist")

except InsufficientCreditsError:
    # 402: not enough credits
    print("Top up your credits first")

except ValidationError as e:
    # 422: invalid input
    print(f"Validation failed: {e}")

except ServerError:
    # 5xx: server error (SDK auto-retries 3x)
    print("Server error after retries")

except EnvizionError as e:
    # Catch-all for any other API error
    print(f"Error: {e}")
    print(f"Status: {e.status_code}")
    print(f"Request ID: {e.request_id}")

import { EnvizionClient, EnvizionError, RateLimitError, NotFoundError } from "@envizion/sdk";

const client = new EnvizionClient("vk_...");

try {
  const run = await client.runs.create({
    agentId: "creative_director",
    inputs: { topic: "AI news" },
  });
} catch (err) {
  if (err instanceof RateLimitError) {
    // 429: wait and retry
    console.log(`Retry after ${err.retryAfter}s`);
    await new Promise(r => setTimeout(r, err.retryAfter * 1000));

  } else if (err instanceof NotFoundError) {
    // 404: resource not found
    console.log("Agent does not exist");

  } else if (err instanceof EnvizionError) {
    // Any other API error
    console.log(`Error: ${err.message}`);
    console.log(`Status: ${err.statusCode}`);
    console.log(`Request ID: ${err.requestId}`);
  }
}

# Check the HTTP status code and parse the error body
response=$(curl -s -w "\n%{http_code}" \
  https://api.envizion.ai/v1/agents/nonexistent \
  -H "X-API-Key: vk_your_key")

body=$(echo "$response" | head -n -1)
status=$(echo "$response" | tail -1)

if [ "$status" -ne 200 ]; then
  echo "Error $status:"
  echo "$body" | python3 -m json.tool
fi