# கோப்புகள்

படம், வீடியோ அல்லது ஆடியோவை ஏற்கும் மாதிரிகள் அவற்றை மூன்று வடிவங்களில் ஏதேனும் ஒன்றில் ஏற்கும். ஒவ்வொரு மாதிரிப் பக்கமும் அதன் கோப்பு
அளவுருக்களைக் குறிக்கிறது (எடுத்துக்காட்டாக `image`, `images`, `videos`, `audios`).

## 1. பொதுவில் அணுகக்கூடிய URL

மாதிரி பதிவிறக்கக்கூடிய எந்த `https://` (அல்லது `http://`) URL:

```json
{ "image": "https://example.com/photos/product.jpg" }
```

கோப்பை cookies அல்லது உள்நுழைவு இல்லாமல் அணுக முடிந்திருக்க வேண்டும்; மேலும் கோரிக்கை தொடங்கும் வரை அது அணுகக்கூடியதாக இருக்க வேண்டும். ஒவ்வொரு மாதிரிப்
பக்கமும் அதன் கோப்பு அளவுருக்களுக்கான அளவு மற்றும் பரிமாண வரம்புகளைப் பட்டியலிடுகிறது.

## 2. தரவு URI

சிறிய கோப்புகளை 10 MB வரையிலான `data:` URI ஆக நேரடியாகச் சேர்க்கலாம்:

```json
{ "image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..." }
```

Base64 காரணமாக உடல் கோப்பைவிட சுமார் மூன்றில் ஒரு பங்கு பெரிதாகும்; எனவே பெரிய கோப்புகளுக்கு பதிவேற்றங்களை விரும்புங்கள்.

## 3. பதிவேற்றம்

உள்ளக கோப்புகளுக்கு, பதிவேற்ற URL-ஐக் கோரி, பைட்டுகளை அங்கே `PUT` செய்து, திருப்பி வழங்கப்பட்ட `file_url`-ஐ மாதிரிக்கு வழங்குங்கள்.
பதிவேற்ற URL உருவாக்குவது இலவசம்.

```bash 1 · பதிவேற்ற URL-ஐப் பெறுதல்
curl -X POST "https://api.doitong.ru/v1/files" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"filename": "product.jpg", "content_type": "image/jpeg", "size": 482113}'
```

```json 201 Created · பதிவேற்றம்
{
  "object": "upload",
  "upload_url": "https://…signed upload URL…",
  "file_url": "https://content.doitong.com/…/product.jpg",
  "method": "PUT",
  "headers": { "Content-Type": "image/jpeg" },
  "content_type": "image/jpeg",
  "expires_in": 3600,
  "max_bytes": 15728640
}
```

```bash 2 · திருப்பி வழங்கப்பட்ட தலைப்புகளுடன் பைட்டுகளைப் பதிவேற்றுதல்
curl -X PUT "<upload_url>" -H "Content-Type: image/jpeg" --data-binary @product.jpg
```

```bash 3 · மாதிரி உள்ளீடாக file_url-ஐப் பயன்படுத்துதல்
curl -X POST "https://api.doitong.ru/v1/run/{model_id}?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"image": "https://content.doitong.com/…/product.jpg", "prompt": "..."}'
```

- ஆதரிக்கப்படும் பதிவேற்றங்கள்: `.jpg`, `.jpeg`, `.png`, `.webp` (15 MB வரை) மற்றும் `.mp4`, `.mov`, `.webm` (200 MB வரை).
  நீட்டிப்பு வகையை அமைக்கிறது; `content_type` அதனுடன் பொருந்த வேண்டும்.
- பதிவேற்ற URL ஒரு மணி நேரத்துக்கு செல்லுபடியாகும். `file_url` தொடர்ந்து செல்லுபடியாக இருக்கும்.
- ஆடியோவுக்கு, பொதுவில் அணுகக்கூடிய URL அல்லது தரவு URI-ஐப் பயன்படுத்துங்கள்.

## வெளியீட்டு கோப்புகள்

> [!TIP]
> உருவாக்கப்பட்ட கோப்புகள் எங்கள் சேமிப்பகத்தில் நகலெடுக்கப்பட்டு, `content.doitong.com`-இல் உள்ள இணைப்புகளாக `outputs[].url`-ல் திருப்பி வழங்கப்படுகின்றன. அவற்றை நேரடியாக மற்றொரு மாதிரியில்
> வழங்கலாம்; எடுத்துக்காட்டாக, உரையிலிருந்து படத்தை உருவாக்கும் மாதிரியின் படத்தைப் படத்திலிருந்து வீடியோ உருவாக்கும் மாதிரியில் வழங்கலாம்.

வெளியீட்டு கோப்புகள் எவ்வளவு காலம் வைக்கப்பட வேண்டும் என்பதை நீங்கள் தேர்வு செய்யலாம்:

- **நிரந்தரமாக** (`permanent`, இயல்புநிலை): அவற்றை நீக்கும் வரை, ஒரு GB-க்கு மாதத்திற்கு 100 API கிரெடிட்கள்
  ($0.10), API இருப்பிலிருந்து ஒரு நாளுக்கு ஒருமுறை வசூலிக்கப்படும் (1 GB = 1024³ bytes).
- **7 நாட்கள்** (`temporary`): இலவசம்; அதன் பிறகு எங்கள் சேமிப்பகத்திலிருந்து நீக்கப்படும்.

[dashboard](https://doitong.com/developers/dashboard#balance)-இல் உள்ள "கோப்பை நிரந்தரமாக வைத்திருக்கவும்" switch மூலம் இயல்புநிலையை அமைக்கலாம் அல்லது
`PATCH /account/storage` மூலம் அமைக்கலாம்; ஒவ்வொரு run-க்கும் `?storage=temporary` (அல்லது `permanent`) மூலம் இதை மாற்றலாம்:

```bash
curl -X PATCH "https://api.doitong.ru/v1/account/storage" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mode": "temporary"}'
```

ஒவ்வொரு கோரிக்கையும் அதன் சொந்த `storage` (`mode`, `bytes`, `expires_at`, `expired`)-ஐக் காட்டும். இந்த அமைப்பு புதிய கோரிக்கைகளுக்குப் பொருந்தும்;
நீங்கள் ஏற்கனவே நிரந்தரமாக வைத்திருக்கும் கோப்புகள், அவற்றை `DELETE /requests/{id}/files` மூலம் நீக்கும் வரை இருக்கும் (பார்க்கவும்
[Requests](https://doitong.com/developers/docs/requests#delete-files)). API இருப்பால் சேமிப்பகத்திற்கான கட்டணத்தைச் செலுத்த முடியாவிட்டால், உங்களுக்கு மின்னஞ்சலும்
30 நாட்களும் வழங்கப்படும்; அதற்குள் மீள்நிரப்பு செய்யாவிட்டால் வைத்திருக்கும் கோப்புகள் தற்காலிகமாக மாறும்.