플레이그라운드

입력

API 키

API 키가 없으면 월 5회까지 무료 테스트 가능

연도

월

일

시

분

타임존

성별

남 여

결과

생년월일을 입력하고 계산을 클릭하세요.

코드 예시

cURL

curl -X POST https://api.float.do/api/v1/partners/v1/manseryeok \
  -H "X-Partner-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "year": 2000,
    "month": 1,
    "day": 15,
    "hour": 14,
    "minute": 30,
    "timezone": "Asia/Seoul",
    "gender": "male"
  }'

입력

API 키 (필수)

궁합 분석은 API 키가 필요합니다

사람 A

생년월일

성별

출생시간 (선택, HH:MM)

사람 B

생년월일

성별

출생시간 (선택, HH:MM)

결과

두 사람의 생년월일을 입력하고 분석을 클릭하세요.

코드 예시

cURL

curl -X POST https://api.float.do/api/v1/partners/v1/compat \
  -H "X-Partner-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "personABirthDate": "2000-01-15",
    "personABirthTime": "14:30",
    "personAGender": "male",
    "personBBirthDate": "2002-06-20",
    "personBBirthTime": "09:45",
    "personBGender": "female"
  }'

입력

API 키 (선택)

프리미엄 문항(93개)을 사용하려면 API 키 필요

버전 선택

무료 라이트 (24문항) 프리미엄 (93문항, ₩10)

랜덤 예시 답변을 자동으로 채웁니다

결과

예시 답변을 로드하고 검사를 실행하세요.

코드 예시

cURL (24문항 샘플)

curl -X POST https://api.float.do/api/v1/partners/v1/personality-type \
  -H "Content-Type: application/json" \
  -d '{
    "tier": "free",
    "answers": [
      {"questionId": "q001", "value": 3},
      {"questionId": "q002", "value": 4},
      ...
    ]
  }'

입력

API 키 (필수)

AI 사주 리딩은 API 키가 필요합니다

연도

월

일

시 (선택)

분 (선택)

성별

남 여

질문 (필수)

파일 첨부

AI 분석 — 기억에 적재

톤 (선택)

최대 길이 (선택)

결과

정보를 입력하고 풀이하기를 클릭하세요.

코드 예시

cURL

curl -X POST https://api.float.do/api/v1/partners/v1/reading \
  -H "X-Partner-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "year": 2000,
    "month": 1,
    "day": 15,
    "hour": 14,
    "minute": 30,
    "gender": "male",
    "question": "당신의 인생 경로와 조언을 해줄 수 있나요?",
    "tone": "warm",
    "maxLength": 800
  }'

입력

API 키 (필수)

AI 사주 리딩 · 메모리는 API 키가 필요합니다

엔드유저 ID (필수)

같은 ID로 호출하면 과거 맥락이 반영됩니다

연도

월

일

시 (선택)

분 (선택)

성별

남 여

질문 (필수)

톤 (선택)

결과

정보를 입력하고 풀이하기를 클릭하세요.

코드 예시

cURL

curl -X POST https://api.float.do/api/v1/partners/v1/reading/memory \
  -H "X-Partner-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "endUserId": "user_12345",
    "year": 2000,
    "month": 1,
    "day": 15,
    "hour": 14,
    "minute": 30,
    "gender": "male",
    "question": "당신의 인생 경로와 조언을 해줄 수 있나요?",
    "tone": "warm"
  }'

입력

API 키 (필수)

이미지 생성은 API 키가 필요합니다

연도

월

일

시 (선택)

분 (선택)

성별

남 여

스타일 (선택)

생성에 20~30초 소요됩니다

결과

정보를 입력하고 이미지 생성을 클릭하세요.

코드 예시

cURL

curl -X POST https://api.float.do/api/v1/partners/v1/image \
  -H "X-Partner-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "year": 2000,
    "month": 1,
    "day": 15,
    "hour": 14,
    "minute": 30,
    "gender": "male",
    "style": "background"
  }'

입력

API 키

텍스트 기반 이미지 생성 (Google/OpenAI 모델 지원)

프롬프트 (필수)

모델 선택

크기

gpt-image는 ~40초, google/fal은 10~20초 소요

결과

프롬프트를 입력하고 이미지 생성을 클릭하세요.

코드 예시

cURL

curl -X POST https://api.float.do/api/v1/partners/v1/images/generations \
  -H "X-Partner-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/nano-banana-pro",
    "prompt": "A serene mountain landscape at sunset with golden clouds",
    "size": "1024x1024",
    "n": 1
  }'

입력

API 키

메모리 관리 API는 무료 (과금 없음)

엔드유저 ID (필수)

사용자의 고유 ID

검색 태그 (선택)

쉼표로 구분된 태그 (태그 검색용)

결과

엔드유저 ID를 입력하고 조회 버튼을 클릭하세요.

코드 예시

cURL — 조회

curl -X GET https://api.float.do/api/v1/partners/v1/memory/user_123 \
  -H "X-Partner-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

입력

같은 모델 + 기억 엔진. endUserId별로 대화를 자동 저장·회상합니다 (리셀가 ×1.30, 회상 맥락도 입력 토큰 과금)

API 키 (필수)

x-partner-api-key 헤더로 전송됩니다

모델 선택

사용자 ID (endUserId)

같은 endUserId로 요청하면 과거 맥락을 서버가 자동 회상합니다 (RIDM 필수 값)

메시지

요약 주기 (summaryEvery)

요약·감정 갱신 주기 (턴) — ridm/* 전용

감정 상태 분석

감정 상태 분석 — ridm/* 전용, 요약 사이클에 편승·추가 과금 없음

파일 첨부

AI 분석 — 기억에 적재

맥락 분할·요약·태그 저장 (RIDM 방식)

결과

메시지를 입력하고 요청하기를 클릭하세요.

코드 예시

JavaScript (OpenAI SDK)

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: process.env.PARTNER_API_KEY,
  baseURL: 'https://api.float.do/api/v1/partners/v1',
});

const response = await client.chat.completions.create({
  model: 'ridm/gpt-5.6-terra',
  user: 'user_123',  // endUserId
  messages: [
    { role: 'user', content: '안녕하세요. 오늘 날씨는 어떤가요?' }
  ],
});

입력

원본 모델 그대로(리셀, 원가 ×1.30). 메모리·감정·파일 자동 회상 없음 — 기억이 필요하면 RIDM 탭에서 model에 ridm/ 접두사만.

API 키 (필수)

x-partner-api-key 헤더로 전송됩니다

모델 선택

사용자 ID (선택 · 리셀은 기억하지 않음)

메시지

결과

메시지를 입력하고 요청하기를 클릭하세요.

코드 예시

JavaScript (OpenAI SDK)

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: process.env.PARTNER_API_KEY,
  baseURL: 'https://api.float.do/api/v1/partners/v1',
});

const response = await client.chat.completions.create({
  model: 'openai/gpt-5.6-terra',
  messages: [
    { role: 'user', content: '안녕하세요. 오늘 날씨는 어떤가요?' }
  ],
});

입력

API 키 (필수)

사주 리포트 생성은 API 키가 필요합니다

연도

월

일

시 (선택)

분 (선택)

성별

남 여

톤 (선택)

페르소나 (선택)

사주 리포트 생성 중... 30초 정도 걸려요

결과

정보를 입력하고 사주 리포트 생성을 클릭하세요.

코드 예시

cURL

curl -X POST https://api.float.do/api/v1/partners/v1/reading/report \
  -H "X-Partner-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "year": 2000,
    "month": 1,
    "day": 15,
    "hour": 14,
    "minute": 30,
    "gender": "male",
    "tone": "warm",
    "persona": "반말 쓰는 20대 애기무당 말투로"
  }'

기능 설정

API 키별 활성화된 기능을 관리합니다. API 키가 없으면 설정할 수 없습니다.

API 키를 입력하면 기능 설정이 표시됩니다.