> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fanifyai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Fichiers

> Envoyez des fichiers à Fanify Hub et utilisez leurs URL temporaires.

Utilisez `POST /api/v1/hub/files` pour obtenir une URL temporaire utilisable dans les champs de modèle au format URI.

```bash theme={null}
curl https://fanifyai.com/api/v1/hub/files \
  -H "Authorization: Bearer $FANIFY_API_KEY" \
  -F "file=@reference.png;type=image/png"
```

```json theme={null}
{
  "id": "8Jd2kQ7pR1sT4uV6wX9yZ0aB2cD4eF6gH8iJ0kL2mN4",
  "url": "https://fanifyai.com/api/v1/hub/files/8Jd2kQ7pR1sT4uV6wX9yZ0aB2cD4eF6gH8iJ0kL2mN4",
  "sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
  "size": 812345,
  "media_type": "image/png",
  "expires_at": "2026-09-08T10:00:00Z"
}
```

Le champ multipart doit s'appeler `file`. La taille maximale est de **50 MiB par défaut**. Elle peut être plus basse selon la configuration du service.

## Réutiliser un fichier par son empreinte

Les champs de modèle au format URI acceptent l'URL temporaire ou une référence `sha256:<64 caractères hexadécimaux>`. Construisez cette référence avec la propriété `sha256` renvoyée par l'envoi.

La référence ne résout qu'un fichier non expiré envoyé par le même compte. Une empreinte inconnue, expirée ou appartenant à un autre compte renvoie `400 invalid_input` lors de la soumission.

## Types acceptés

Images : `image/png`, `image/jpeg`, `image/webp`, `image/gif`.

Vidéos : `video/mp4`, `video/webm`, `video/quicktime`.

Audio et documents : `audio/mpeg`, `audio/wav`, `audio/ogg`, `application/pdf`, `application/octet-stream`.

<Warning>
  Les fichiers envoyés expirent après **24 heures par défaut**. Les sorties générées expirent après **7 jours par défaut**. Les valeurs effectives restent indiquées dans `expires_at` et peuvent varier selon la configuration du service. Un téléchargement expiré renvoie `410 file_expired`.
</Warning>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.