# SciFig API

HTTP로 과학 그림, 그래프, 순서도를 만들 수 있습니다. 엔진, 가격, 크레딧은 SciFig 웹사이트와 동일합니다.

출처: https://scifig.ai/ko/docs/api

## 빠른 시작

- [설정 → 개발자](/ko/app/settings?tab=developer)에서 API 키를 만드세요. 생성용 키에는 활성 구독 또는 0보다 큰 크레딧 팩 잔액이 필요합니다. 읽기 전용 키는 모든 계정에서 사용할 수 있습니다.
- `Idempotency-Key`를 포함해 생성 요청을 보내세요. `Prefer: wait=25`를 지정하면 최대 25초 동안 기다리며, 그 안에 완료되면 완료된 작업을 반환합니다.
- 작업이 아직 `queued` 또는 `processing`이면 `Retry-After`에 따라 몇 초 간격으로 `GET /jobs/{id}`를 조회해 `succeeded` 또는 `failed`가 될 때까지 확인하세요.
- 각 출력의 `download_url`(유효 기간 1시간)에서 다운로드하거나 `file_id`를 다른 엔드포인트에 전달하세요.

```bash
curl -X POST https://scifig.ai/api/v1/images/generations \
  -H "Authorization: Bearer $SCIFIG_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Prefer: wait=25" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Mitochondrial electron transport chain, labelled", "aspect_ratio": "4:3"}'
```

기본 URL: `https://scifig.ai/api/v1`. 기계 판독용 명세: [OpenAPI JSON](https://scifig.ai/api/v1/openapi.json) 및 [OpenAPI YAML](https://scifig.ai/api/v1/openapi.yaml). AI 어시스턴트는 [MCP 서버](/ko/mcp)로 같은 기능을 사용할 수 있습니다.

## 엔드포인트

| 엔드포인트 | 기능 | 크레딧 |
| --- | --- | --- |
| POST /images/generations | 프롬프트로 과학 그림 생성 | 50 / 75 / 100 |
| POST /images/edits | 지시 또는 영역 지정 편집, 흰색 배경, 화면 비율 변경, 색상 변경, 텍스트 교체 | 50 / 75 / 100, 영역 편집 또는 텍스트 교체는 100 |
| POST /images/text-detections | 텍스트를 교체하기 전에 이미지 속 텍스트 감지 | 0 |
| POST /images/upscales | 2K, 4K 또는 8K로 업스케일 | 50 / 100 / 150 |
| POST /images/conversions | SVG 벡터화 및 PNG, PDF, TIFF, PPTX 내보내기 | SVG는 150, PNG, PDF, TIFF 및 PPTX는 무료 |
| POST /charts/generations | CSV, TSV 또는 Excel 데이터로 그래프 작성 | 100 |
| POST /charts/edits | 그래프의 최신 버전 수정 | 100 |
| POST /flowcharts/generations | SVG 순서도 작성 | 100 |
| POST /flowcharts/edits | 순서도의 최신 버전 수정 | 100 |
| POST /files | 이미지, 마스크 또는 첨부 파일 업로드 | 0 |
| GET /files/{file_id} | 파일 다운로드 | 0 |
| GET /jobs/{id} | 작업 한 건 조회 | 0 |
| GET /jobs | 최근 작업 목록 조회 | 0 |
| GET /credits | 잔액, 요금제 및 작업 제한 | 0 |
| GET /pricing | 전체 가격(인증 불필요) | 0 |
| GET /openapi.json | OpenAPI 3.1 명세(인증 불필요) | 0 |
| GET /openapi.yaml | 동일 명세의 YAML 버전(인증 불필요) | 0 |

Webhook, SDK 또는 명령줄 도구는 제공하지 않습니다. 서버나 스크립트에서 엔드포인트를 직접 호출하세요(API는 브라우저의 CORS 요청을 허용하지 않습니다).