Мазмұнға өту

Sana

Интеграциялау

Модель идентификаторы sana
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/sana?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Осы сұрау: 0,008 $ 8 API кредиті Осы бетте іске қосу

API кілтін алу

18 қадамдық әдепкі мәні және стиль алдын ала баптаулары бар, әдепкіде 3840x2160 шығыс беретін базалық Sana мәтіннен сурет жасайтын моделі

NVIDIA · Кескін

Алғашқы нәтижеңіз осында пайда болады

Төменде сұрау құрып, оны API кілтіңізбен іске қосыңыз. Шығыстар сақтау орнымызға көшіріліп, мәңгі немесе 7 күн тегін сақталады.

Сұрау жасау

Басқару элементтері модель схемасынан жасалады. Оларды өзгерткен сайын код пен баға жаңартылады.

•міндетті

Кескін генерациясын басқаратын нұсқау.

image_size әдепкі {"height":2160,"width...

Генерацияланған кескін өлшемдері.

num_images әдепкі 1

Генерацияға сұралған кескіндер саны.

Қосымша negative_prompt · output_format · style_name · num_inference_steps · guidance_scale · seed · enable_safety_checker
әдепкі

Кескіннен алып тасталатын түстерді, нысандарды, көріністерді немесе ұсақ белгілерді көрсететін теріс нұсқау. Мысалдар: мұрт, бұлыңғырлық немесе төмен ажыратымдылық.

output_format әдепкі jpeg

Нәтижедегі кескіннің файл пішімі.

әдепкі (No style)

Кескін генерациясына арналған визуалдық стиль.

әдепкі 18

Орындалатын инференс қадамдарының саны.

әдепкі 5

Кескін таңдау кезіндегі нұсқауға сәйкестік күші CFG (Classifier Free Guidance) ретінде көрсетіледі.

Қайталанатын кескіндерге арналған seed: модель нұсқасы өзгермесе, бірдей нұсқау мен seed бірдей кескін жасайды.

POST /run/sana?wait=20 бағасы → 0,008 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/sana?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Осы сұрауды іске қосу

Кілтіңіз осы браузерде қалады: ол тек Doitong API-ге жіберіледі және Remember параметрін белгілеcеңіз ғана localStorage ішінде сақталады. API кілтін алу

Sana туралы

Мәтіндік `prompt`, теріс нұсқау, сид және бағыттау масштабы (0-ден 20-ға дейін) арқылы кескіндер генерациялайды. Әдепкі өлшемі 3840x2160, сондай-ақ square_hd немесе portrait_16_9 сияқты алдын ала орнатылған параметрді таңдауға болады. `num_inference_steps` 1-ден 50-ге дейін орындалады (әдепкісі 18). jpeg немесе png форматында бір сұрауға 1-ден 4-ке дейін кескін, Anime немесе Cinematic сияқты міндетті емес стильдермен жасалады.

Параметрлер

Канондық атауды немесе төл атауды жіберіңіз, екеуін қатар жібермеңіз. Канондық атаулар

АтауыТүрі ӘдепкіРұқсат етілген Сипаттама
promptміндетті
Түріstring
Кескін генерациясын басқаратын нұсқау.
negative_promptміндетті емес
Түріstring
Әдепкі
Кескіннен алып тасталатын түстерді, нысандарды, көріністерді немесе ұсақ белгілерді көрсететін теріс нұсқау. Мысалдар: мұрт, бұлыңғырлық немесе төмен ажыратымдылық.
image_sizeміндетті емес
Түріobject
Әдепкі{"height":2160,"width":3840}
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Генерацияланған кескін өлшемдері.
num_inference_stepsміндетті емес
Түріinteger
Әдепкі18
1 – 50
Орындалатын инференс қадамдарының саны.
seedміндетті емес
Түріinteger | null
Қайталанатын кескіндерге арналған seed: модель нұсқасы өзгермесе, бірдей нұсқау мен seed бірдей кескін жасайды.
guidance_scaleміндетті емес
Түріnumber
Әдепкі5
0 – 20
Кескін таңдау кезіндегі нұсқауға сәйкестік күші CFG (Classifier Free Guidance) ретінде көрсетіледі.
num_imagesміндетті емес num_outputs
Түріinteger
Әдепкі1
1 – 4
Генерацияға сұралған кескіндер саны.
enable_safety_checkerміндетті емес
Түріboolean
Әдепкіtrue
Қауіпсіздікті тексеру: қауіпті деп белгіленген кескіндердің орнына қара кескіндер қайтарылады. true мәні тексеруді қосады; false мәні оны тек авторизацияланған есептік жазбалар үшін өшіреді, ал авторизациясыз сұраулар бәрібір тексеріледі.
output_formatміндетті емес
Түріenum
Әдепкіjpeg
jpegpng
Нәтижедегі кескіннің файл пішімі.
style_nameміндетті емес
Түріenum
Әдепкі(No style)
(No style)CinematicPhotographicAnimeMangaDigital ArtPixel artFantasy artNeonpunk3D Model
Кескін генерациясына арналған визуалдық стиль.
міндетті Канондық атау, бұл да қабылданады

Шығыс

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "sana",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 8,
    "usd": "0.008",
    "charged": 8,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "output": {
    "images": [
      {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "width": 1024,
        "height": 768,
        "content_type": "image/jpeg"
      }
    ],
    "timings": {},
    "seed": 42,
    "has_nsfw_concepts": [
      false
    ],
    "prompt": "string"
  },
  "outputs": [
    {
      "type": "image",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Файлдарыңыз — таңдауыңызӘр outputs[].url — сақтау орнымыздағы көшірме: мәңгі (әр GB-ай үшін ақылы) немесе аккаунт параметрі не ?storage= арқылы 7 күн тегін сақталады.
Әр модельдегі пішім бірдейtype, url, content_type, width, height және duration — кескіндерге, бейнеге және аудиоға ортақ. output — модельдің өз нәтижелер нысаны.
Шығыс өрістері
images
array of object {url, width, height, content_type}Генерацияланған кескіндер туралы файл ақпараты.
timings
object
seed
integerКескін генерациясының seed мәні: кірісте seed көрсетілмесе, кездейсоқ таңдалған мәнді қамтиды; әйтпесе берілген мәнді қайталайды.
has_nsfw_concepts
array of booleanГенерацияланған кескіндерде NSFW ұғымдарының бар-жоғын көрсетеді.
prompt
stringКескін генерациясы кезінде қолданылатын нұсқау.

Қосымша модельдер: Мәтіннен кескінге

AI агенттеріне: бұл беттің Markdown нұсқасы мына жерде: https://doitong.com/kk/developers/models/sana.md. Барлық модельдер мен нұсқаулықтар: https://doitong.com/developers/llms.txt