organization_id string required
Reference to the Organization this provider integration belongs to.
provider_name string required
Name of the AI provider. One of: aitronos, openai, anthropic, clipdrop.
provider_org_id string | null optional
Provider's organization identifier (e.g., OpenAI organization ID).
provider_project_id string | null optional
Provider's project identifier (if applicable, e.g., OpenAI project ID).
provider_api_key string | null optional
Provider's API key (encrypted at rest). Used for authenticating requests to the provider.
is_active boolean required
Whether this provider integration is active and can be used. Default: true.
created_at string required
Timestamp when the provider integration was created. Format: ISO 8601 datetime string.
updated_at string required
Timestamp when the provider integration was last updated. Format: ISO 8601 datetime string.
- Native Freddy AI models
- Models:
ftg-2.0,ftg-2.0-mini,freddy-* - No external credentials required
- Always enabled by default
- GPT models and DALL-E
- Models:
gpt-4o,gpt-4o-mini,gpt-4-turbo,dall-e-3,dall-e-2 - Requires:
provider_api_key - Optional:
provider_org_id,provider_project_id
- Claude models
- Models:
claude-3-5-sonnet,claude-3-opus,claude-3-haiku - Requires:
provider_api_key - Optional:
provider_org_id
- Image operations (upscale, cleanup, background removal)
- Models:
clipdrop-text-to-image,clipdrop-upscale,clipdrop-cleanup,clipdrop-remove-background,clipdrop-replace-background - Requires:
provider_api_key - Credit-based billing
Organizations can have multiple active provider integrations simultaneously:
- Use OpenAI for GPT models
- Use Anthropic for Claude models
- Use Freddy for proprietary models
The system automatically routes requests to the appropriate provider based on the model selected.
- API keys are encrypted at rest
- Keys are never exposed in API responses
- Provider credentials are validated before activation
- Failed authentication attempts are logged
OpenAI Integration
{
"organization_id": "ORG_A1B2C3D4E5F6G7H8",
"provider_name": "openai",
"provider_org_id": "org-1234567890abcdef",
"provider_project_id": "proj-abcdef1234567890",
"provider_api_key": "[ENCRYPTED]",
"is_active": true,
"created_at": "2025-01-10T09:00:00Z",
"updated_at": "2025-01-15T14:30:00Z"
}Anthropic Integration
{
"organization_id": "ORG_A1B2C3D4E5F6G7H8",
"provider_name": "anthropic",
"provider_org_id": "org-anthropic-xyz789",
"provider_project_id": null,
"provider_api_key": "[ENCRYPTED]",
"is_active": true,
"created_at": "2025-01-10T09:05:00Z",
"updated_at": "2025-01-10T09:05:00Z"
}Aitronos (Freddy) Integration (Native)
{
"organization_id": "ORG_A1B2C3D4E5F6G7H8",
"provider_name": "aitronos",
"provider_org_id": null,
"provider_project_id": null,
"provider_api_key": null,
"is_active": true,
"created_at": "2025-01-10T09:00:00Z",
"updated_at": "2025-01-10T09:00:00Z"
}ClipDrop Integration
{
"organization_id": "ORG_A1B2C3D4E5F6G7H8",
"provider_name": "clipdrop",
"provider_org_id": null,
"provider_project_id": null,
"provider_api_key": "[ENCRYPTED]",
"is_active": true,
"created_at": "2025-01-10T09:00:00Z",
"updated_at": "2025-01-10T09:00:00Z"
}Inactive Provider
{
"organization_id": "ORG_A1B2C3D4E5F6G7H8",
"provider_name": "openai",
"provider_org_id": "org-old-1234567890",
"provider_project_id": "proj-old-abcdef1234",
"provider_api_key": "[ENCRYPTED]",
"is_active": false,
"created_at": "2025-01-05T08:00:00Z",
"updated_at": "2025-01-14T16:45:00Z"
}